Vuu-do Files

Note from greenjeans:

Vuu-do is not a distro. It is a project, a user re-spin. It is not really suitable to be widely distributed, there is much hackiness, all of which actually make it run faster and better for it's intended purpose, but hackiness nonetheless. In general, the smaller your operating system, the faster it is, this is why I go so hardcore on getting rid of anything that's not being used. The small size also leaves lots of room to add programs and still come in smaller than CD size for your own iso. In addition, I have no experience with other languages and locales, or the mechanisms by which linux implements them, so I try to stick with things i'm familiar with and know to work and can support. So for right now, english and utf-8 are the only options available in Vuu-do. A determined user could fairly easily re-build Vuu-do to run another language/locale. Please feel free to do so, use anything here as you see fit and make it your own!

Greenjeans is not a developer, just a Veteran Unix User. ;) 

All Vuu-do images include Refracta-snapshot and Refracta-installer, making it easy for anyone to "roll their own", users are actively encouraged to do so! 

Vuu-do came about as a project to build a small, fast, lightweight purpose-driven operating system for used computers that are common in pawnshops and the secondhand market, and in use for lots of people. I fix/refurbish these old computers for people when their Windoze installs become unuseable, these are typically poor blue-collar folks who don't have the money for a new machine and can't really afford repairs that only perpetuate their Windoze nightmare anyway.

I have updated the below release notes to reflect some changes made to Miyolinux which was the inspiration for Vuu-do openbox, I added some things but I got rid of a lot too, so if you don't see it, assume it's gone. This is not a complete list. Changes I made are noted with a star * preceding the entry, all others are part of the original Miyolinux release notes. Other changes are detailed in the Vuu-do release notes below.

This is a minimal setup meant to be a base to build on with the programs/packages of your choice, it's got most of the basic infrastructure and is actually pretty cushy for openbox.

VUU-DO stands for Veteran Unix User-do, because if I can do it, so can you. And all thanks to a lot of great VUA's who make VUU's possible, please support Devuan and init-freedom! :D

Vuu-do is powered by Devuan with the help of a whole lotta fsmithred/Refracta magic and Miyolinux soul.

*Live User Information:

*Login Name = vuudo
*Password   = vuudo
*Root/Su password = root
________________________________________________________________________________________________________

Vuu-do Linux Openbox-32-minimal 1.0.0 (non-uefi version) Release Notes:

A few basics first: This is Openbox, expect less in the way of convenience unless you change it. It will also use less ram and be quicker. No desktop icons in Vuu-do, Openbox and Pcmanfm do have this capability, it's just not set up that way in Vuu-do. No dropping icons into the panel either, use Tint2 Settings to add/subtract apps and icons and other panel content. You can right-click anywhere in the desktop and also in clear areas of the panel and it will open the main menu. This may be different than what you are used to, try it, you might like it. If not, try the Mate version for more drag-n-drop functionality.

----------------
Trimming the fat
----------------

This is how I get the iso's so much smaller, and also part of the reason Vuu-do is more of a project than a distribution. Over 100 mb of files in /usr/share/doc, hundreds more in translations and locales, help files, backup files, etc. In general it is assumed Vuu-do will be used by advanced users who don't need these things and would rather have the space filled with something useful to them.

---------------------------------
Multi-user vs. single-user system
---------------------------------

Vuu-do is set up as a single-user system, I doubt many people still run multi-user systems, especially not in laptops. Adding a user will require invoking useradd, and Vuu-do does NOT currently have an /etc/skel file, to add another user you would need to make your own /etc/skel/, or alternately run as-is which will get you a very basic user profile then drop a custom dconf config file from another partition into the new user's home, or just make it and config it from the ground up.

TO-DO: I might make a Vuu-do /etc/skel file at some time in the future if I get enough requests for one.

----
Menu
----

The Menu as noted below is dynamic, it will add/subtract entries in the menu automatically as applications are installed/removed. But it can be static as well
like the entries under the "Vuu-do Linux" section, and you can edit/add/subtract them. You can also delete the installer section at the top "Live CD/USB" along with the installer entry after you have installed the system from live media. It's the same Refracta-installer that's elsewhere in the menu if you need it later to make your own iso.

To edit, open the menu and go to Configuration >> Advanced Settings >> Obmenu-Generator >> Edit Menu Schema , this will open the file
in Pluma (text-editor) for you to edit.

<hackiness> I couldn't find a .deb of obmenu-generator that didn't still include cpanminus and other things as dependencies that are not really dependencies, cpan was needed to build the package originally, and someone just packaged it as-is still listing depends no longer needed. Obmenu-generator is not currently a Devuan package, but that might change in the future, so for now what i've done is delete the package and all those depends from Vuu-do, but I restored the actual executable (/usr/bin/obmenu-generator, there's also a schema template in /etc/obmenu-generator) and the config files in user's home (~/.config/obmenu-generator/*) and root's home, the program really only requires Perl and a couple of small libraries, so it works normally. When it gets re-packaged i'll add the package to Vuu-do. </hackiness> 

-------
Vuu-do don't sudo (not by default anyway)
-------

Sudo is installed but there is no one listed in the sudoers file on the livecd. You can add your user during the install process, or add after install using visudo. Su works everywhere, that's what I use instead of sudo, so for all root tasks on the livecd use su. If you want to run your machine this way after install, simply un-check all the sudo options when that screen pops up during install. Username/passwords for the livecd:

vuudo (user account) = vuudo
root = root

You can choose to enable/disable autologin for your user during install. To change autologin settings after install, edit /etc/lightdm/lightdm.conf as root.

------------------------------
Power management/screen-locker
------------------------------

The xfce power manager is installed and most functions work other than the options for when you close the lid on your laptop. Suspend, hibernate etc. all work fine.

No screensaver is installed, xscreensaver works fine if you want a full screensaving app, and it's available in the repo.

Screen-locking is enabled and shortcut is noted in conky display (Alt + l) in addition to main menu. This is only a locker, not a screensaver, the program is i3lock and it just blanks/locks your screen. 

To unlock simply type your password and hit enter, i3lock doesn't give you a pretty unlock-gui like mate-screensaver or xscreensaver, you just get a simple green circle once you start typing and then after you finish and hit enter it unlocks immediately. So there is no daemon running sucking up power and ram, and the i3lock program and dependencies only add up to half a MB, so it's lightweight and very quick.

----------------------
Wallpapers/backgrounds
----------------------

To change desktop background, go to menu then Configuration >> Settings >> Nitrogen

To add your own desktop backgrounds, drop them into /usr/share/images/Wallpapers. You don't need to be root. The next time you open Nitrogen (wallpaper-setter in menu), they'll be there. You can delete any existing wallpaper in that folder but.... 

.....the main Vuu-do wallpaper (vuudo11.jpg) is also being used as the background for lightdm (log-in manager), so if you delete it you'll need to provide another background image for it, go to /etc/lightdm/lightdm-gtk-greeter.conf and edit this line "background=/usr/share/images/Wallpapers/vuudo11.jpg" to the correct new image you want to use. You can also change gtk theme, fonts, etc.

To change grub background, you'll need to provide a .png image named "desktop-grub.png", and use it to replace the same file in /boot/grub/. I'm pretty sure it needs to be 4:3 res, but I could be wrong about that, and it needs to be smaller than 500k or it won't work, the smaller the better, the one I used is 1600x1200 and about 200k.

-----------
Panel/Tint2
-----------

To add or subtract items from the panel or change it's size/color, open the menu and look under Configuration >> Settings >> Tint2 Settings, clicking that will open a nice GUI for editing the Tint2 config file, click "Edit Theme" up at the top left of that window to start editing. This makes Tint2 a lot more appealing than it used to be, it's super lightweight but still does pretty much everything you need a panel to do.

----
Grub
----

I fixed a small issue with grub, in that if you run update-grub after you're system is installed, it was defaulting to listing this OS as "Debian", it was in the /etc/default/grub file, the grub script reads this when you update grub and defaults to the grub_distributor as name for the main listing in grub. I changed this line so it will recognize Vuu-do when you update-grub.

Also modded os-probes so grub will recognize/label Devuan installs on other partitions, and will recognize other Vuu-do installs as well.

If an update appears for the package "os-prober", be aware that updating that (unless it gets fixed), will wipeout the patching that i've done and will run update-grub as a part of the update, so your grub menu will show "unknown linux distribution" for any additional Devuan or Vuu-do partitions you have. The file you need to preserve is : /usr/lib/os-probes/mounted/90linux-distro , make a copy of that and stash it somewhere before you do your update, then replace the updated file with the custom one after install/update.

-----
Other
-----

Resolution is usually set automatically to the best res your monitor is capable of with the open-source drivers, if you want to change this you can use xrandr in terminal, or install "arandr" from the repo for a graphic interface to xrandr. To do any better than the open-source driver you would need to install proprietary drivers for your graphics chip, those are available in the repo too, but do take some work to do right.

Fixed an issue with pcmanfm not mounting other partitions with a click, had to change some policy in /usr/share/polkit-1/actions/org.freedesktop.udisks2.policy, if you open that file you'll see the portions relating to disk-mounting. I set it so user can mount/open with a click and view files, you'll still need to gksu to root if you want to alter system files in those partitions or see into protected files.

Bluetooth support is onboard, but not enabled to start on boot, use Boot-Up Manager from the menu to start the service and enable on boot-up. You may also need to install the package "firmware-bluetooth" for your devices to work. Saned is also configured not to auto-start on boot, you can enable it in Boot-Up manager as well.

Added a bunch of wi-fi firmware to try and cover as many computers as possible, if you know what firmware your machine needs to connect you can safely un-install the rest, there are also AMD and Intel microcode packages onboard.

FOR BEST INSTALLATION RESULTS, PLEASE USE THE EXPERT INSTALL.

---------------------------------------------------------------------------------
---------------------------------------------------------------------------------

MiyoLinux Release Notes

MiyoLinux was made so that users could have a base system on which to add the software and 
applications they choose. Miyo is simply an acronym for "make it your own".

*Live User Information:

*Login Name = vuudo
*Password   = vuudo
*Root/Su password = root
       _____________________________________________________________________________

Changes in this release:

*Updated fully as of 08-07-2017

*Refracta installer now in the menu, you can edit the extra entry out of the top "Live CD/USB" portion 
 of the menu after install by using: Menu >> Advanced Settings >> Obmenu-Generator >> Menu Schema

FOR BEST INSTALLATION RESULTS, PLEASE USE THE EXPERT INSTALL.


Added the ability to disable touchpads in the Autostart file.
Added a few Keyboard shortcuts for user's convenience (see more information below).
Changed MiyoLinux Gray Theme to the newer colors.
*Added clipboard manager, picture viewer, calculator, text-editor (Pluma), testdisk, boot-up manager
*Added Ralink and other wi-fi firmware
*Added Oxy2-ZEN icons
*Modded os-probes, grub now recognizes Devuan, and will recognize other Vuu-do installs, and will still show Vuu-do if you update-grub.
*Updated Refracta tools to latest versions, added the snapshot gui package and helper packages for lightdm
*Added a conky on/off switch to the menu, and changed conkyrc settings, and set it to autostart
*Changed grub, lightdm, and desktop backgrounds
*Changed some colors in the Numix Frost theme
*Changed parcellite's icon colors, looked silly in the tray with everything else gray-ish
*Added a couple of right-click context options to pcmanfm, Open Folder As Root and Edit File As Root
*Added i3lock screenlocker
       _____________________________________________________________________________
 

*Here are a few keyboard shortcuts that have been added for your convenience. Please note that the font used on the conky display writes in all caps regardless of case, but all shortcuts use alt + (lower-case) letters to activate the shortcuts as properly listed below.

alt + f = file manager
alt + a = application launcher
alt + t = terminal
alt + l = lock screen
alt + s = suspend 
alt + h = hibernate
alt + r = reboot
alt + p = power-off/shutdown
prt sc  = take screenshot 
----------------------------------

       _____________________________________________________________________________

Following are a few notes regarding "The Menu", "Conky", "If your time is wrong".
Please take a moment to read through them.

1. THE MENU

The menu is dynamic; therefore, it will automatically add and remove applications as they 
are installed or removed. It is set for icons to be included in the menu. Menu icons can be 
enabled or disabled by opening your menu and going to...

Advanced Settings > Obmenu-Generator > Remove Menu Icons ...or... Add Menu Icons
       ________________________________________________________________________________

2. CONKY

Now set to autostart by default.

      _________________________________________________________________________________

3. IF YOUR TIME IS WRONG AFTER USING THE SIMPLE INSTALLATION (EXPERT INSTALL IS PREFERRED) 

If your time is wrong, open your terminal, and enter the following command...

sudo dpkg-reconfigure tzdata

...then follow the onscreen instructions to set your time zone. In most cases, this step is
all that will be needed. Sometimes it's necessary to change your hardware clock time in BIOS.

If not, you might need to install the "ntp" package and possibly "ntpdate",
they will update your time based on online ntp servers.
       _______________________________________________________________________________



Finally, my thanks go out to both Devuan and Refracta...MiyoLinux wouldn't be possible without
either of them.

                 www.devuan.org                 www.ibiblio.org/refracta/

Also, my sincere thanks to anyone who may use MiyoLinux! I hope you enjoy it!
______________________________________________________________________________________________________