
MiyoLinux Rolling Release Notes

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

PLEASE READ THE "LIVE USER NOTES" FOR INSTRUCTIONS ON HOW TO CONNECT TO YOUR WIRELESS NETWORK AND HOW TO CHANGE THE KEYBOARD LAYOUT.

Live User Information:

Username = miyo
Password = miyo
Root password= miyo

			__________________________________________________________________________________
	

SPECIAL NOTE FOR NON-ENGLISH INSTALLATIONS

Hopefully, this release will make it easier for users who install MiyoLinux in a language/locale other than English. I have included all locales in this build; however, a user will still need to install the appropriate "task" packages for their language/locale. This can easily be done by opening the Synaptic package manager and searching for...

     task-your-language

For example, if you are installing in German, you would search for...

     task-german

Many of the task packages have more than one package; such as, German offers...

     task-german
     task-german-desktop

You may want to install all of the appropriate packages that are listed for your specific language/local.

       		__________________________________________________________________________________


RELEASE NOTES

MiyoLinux Rolling
     
Please be aware that this build is based on Devuan ceres; which is, the UNSTABLE branch of Devuan. Please use at your own risk. Don't take this the wrong way...but please only install MiyoLinux Rolling if you're experienced and know what you're doing. :)

       		__________________________________________________________________________________
       	
       		
Immediately after installation, open your terminal and at least run the following command...

	sudo apt-get update

...otherwise, the repositories may not be active until you do so. You may also want to go ahead and run...

	sudo apt-get dist-upgrade


PLEASE NOTE: MIYOLINUX INCLUDES THE CONTRIB AND NON-FREE REPOSITORIES

       		__________________________________________________________________________________
       

Here are a few keyboard shortcuts for users' convenience. W = Windows key (Superkey).
       
W + Space = Menu
W + b = Browser (will open the browser assigned as the x-www-browser by your system)
W + d = Show Desktop (Minimize all windows)
W + f = File Manager
W + q = Exit Menu
W + F1 - F4 = Switch Desktops
Alt + F2 = rofi (application launcher)
Ctrl + Alt + t = Terminal
PRTSC = Scrot (Screenshot of desktop)
(all screenshots go into the Pictures folder...including the ones from the Openbox menu)

       		__________________________________________________________________________________
       

NOTES ON THIS RELEASE


!!! IMPORTANT NOTE: If you install MiyoLinux-Rolling and receive an error during the installation of grub, go ahead and click Continue. On one of my testing machines, this would happen...but not on the others. The error had to do with copying a certain locale. You may (or may not) experience this situation.


 1. Upgrade with care!				 
 2. PulseAudio and Pavucontrol are not included in this build
 3. How to enable sound with alsa if you have more than one sound card
 4. How to activate the firewall with UFW
 5. Regarding Hibernate in the Exit menu
 6. PCManFM (as root) and Customize look and feel (as root) now use pkexec
 7. Included the papirus-folders script to change Papirus folder colors
 8. The Openbox right-click menu 
 9. No gvfs
10. Screenshots

       		__________________________________________________________________________________
       

1. Upgrade with care!

Please upgrade your system with care! You may want to install the package...

	apt-listbugs

If something doesn't look right, or apt-listbugs shows problems...just upgrade particular packages that aren't affected by bugs or wait a day or two (or more) to upgrade. 

    		________________________________________________________________________________


2. No PulseAudio or Pavucontrol

At the time of this build, pulseaudio and pavucontrol were having issues in ceres; therefore, I chose to use only alsa for sound. I did include apulse though. 

If you have more than one sound card, and you have no sound after installation, please see the next item below in order to have sound with alsa.

			________________________________________________________________________________


3. How to enable sound with alsa if you have more than one sound card

Many thanks to my friend mlsmith for adding this to the MiyoLinux wiki long ago. :)

	a)	Run the following command (in your terminal) to see which order ALSA assigned your cards:


		cat /proc/asound/cards


		In my case I got:

		0 [HDMI ]: HDA-Intel - HDA Intel HDMI
		HDA Intel HDMI at 0xe0510000 irq 61 
		1 [PCH ]: HDA-Intel - HDA Intel PCH
		HDA Intel PCH at 0xe0514000 irq 59


	b)	In your terminal, tell the kernel to load the intel driver with 1 as the default :


		sudo bash -c 'echo "options snd_hda_intel index=1,0" > /etc/modprobe.d/alsa.conf'


	c)	You can verify the driver name to use above by running the following command in your terminal:


		lsmod | grep snd


	d)	Reboot the computer and you should have sound!
	
			_______________________________________________________________________________


4. How to activate the firewall with UFW.

To activate the firewall after installation, open the terminal, and as root, enter the following commands one at a time...

	ufw default deny

	ufw enable

That will enable the firewall with the default to deny incoming. It will then be active upon subsequent reboots. You can check the firewall status at any time afterwards by opening your terminal as root and issuing this command...

	ufw status
	
			______________________________________________________________________________


5. Regarding Hibernate in the Exit menu.

If you want to use Hibernate from the Exit Menu, you will need to install the hibernate package from the repositories. I chose this route, because if I had included it preinstalled, a user would need to reconfigure hibernate...which can be confusing.

	apt install hibernate

			_______________________________________________________________________________


6. PCManFM (as root) and Customize look and feel (as root) now use pkexec

Since gksu is deprecated and no longer available, I created pkexec files for both of those items found in the "Other" category of the menu. 

Be aware that when you use the menu entry for PCManFM (as root), it won't show any folders when it opens. You will need to click on "Filesystem Root" in the sidebar to populate the folders.
 
    		_______________________________________________________________________________
  
    
7. Included the papirus-folders script to change Papirus folder colors

I have also included the Papirus icon theme along with a script that will allow the user to choose the folder color that they want to use. :) The script is the official script provided by the Papirus icon theme developers. To use the script...

	a) First, make sure that you're using the Papirus icon theme with Customize look and feel.
	
	b) Next, to view the available colors, open your terminal, and enter the following command...
		
		papirus-folders -l
		
	c) After deciding which color you want to use, enter the following command as root (su or sudo)...
		
		sudo papirus-folders -C your-color
		
		For example, if you wanted to use the black folders, you would enter...
		
		sudo papirus-folders -C black
		
		The new folder color will appear the next time you open your file manager. 
		
		PLEASE NOTE: according to the Papirus developers, you may have to run the script each
		time a new version of the Papirus icon theme is installed by an update to your system.
    
   			 _______________________________________________________________________________
    
    
8. The Openbox right-click menu is obmenu-generator

Many thanks to the developer for providing obmenu-generator! It will automatically add (or remove) applications from the menu. 
	
			_______________________________________________________________________________


9. No gvfs

I originally installed gvfs in order to have the Trash available in the file manager and to make the mounting of USBs and other partitions easy. However, the Refracta Installer requires gparted as a dependency. When gparted was installed, it removed gvfs. I'm not sure if this is just a temporary situation with ceres or not. If you know how to mount items without gvfs, it's not needed. However, if you want the convenience of using it, you can install it after installating the system.

If you do install gvfs, you will first need to remove gparted...

	sudo apt-get remove gparted

Running that command will remove both gparted and the Refracta Installer. If that's okay with you, then install gvfs...

	sudo apt-get install gvfs

After that, you will have the Trash available and you'll be able to easily mount items.

			_______________________________________________________________________________


10. Screenshots

All screenshots will appear in your home folder. Due to the nature of obmenu-generator, it wasn't possible for me to make them appear in the Pictures folder.

			_______________________________________________________________________________
			
			
    
MISCELLANEOUS NOTES


IF THE LAUNCHERS FOR INSTALL MIYOLINUX AND WELCOME TO MIYOLINUX REMAIN IN YOUR MENU AFTER INSTALLATION...

I've had some reports that the installer and welcome screen launchers remained in the menu after installation. I've not been able to reproduce it, so I'm not sure why they're remaining in some installations. 

If this happens to you, open the file manager and have it show hidden files. Go to...

~/.local/share/applications

...and remove the two launchers.

			_______________________________________________________________________________


THE ROOT ACCOUNT DOESN'T ADOPT THE THEME OR ICONS THAT I'M USING

Not all of the changes that you make through "Customize Look and Feel" will not carry over to the root account. To make the root account adopt the same changes, just open the menu, and go to...

	Miyo Accessories > Customize Look and Feel (as Root)

Click on it, enter your password, and that will open "Customize Look and Feel" as root. You can then make the changes to the root account's appearance to match the normal user account's appearance.

			_______________________________________________________________________________


USING THE REFRACTA TOOLS IN MIYOLINUX


PLEASE NOTE: I have all of the Refracta tools locked at their current version; therefore, newer versions of the Refracta tools won't be installed unless you unlock them through Synaptic. My reason for locking them is...

	a) 	Everything is already set up; therefore, a user (who may be unfamiliar with how to use the tools)
		won't have to set anything up themselves.
	b)	If a new version of the Refracta Installer is introduced, it will then appear in the menu which
		may cause some confusion.

Here is what is included...

	a) 	Refractasnapshot base (terminal only...no GUI)
	b) 	Refractainstaller base and GUI

After setting your system up how you want it, you can make an .iso of your system which can then be reinstalled on your computer or other computers. :)

To include the GUI installer in your .iso for easy installation, you will first need to open the file manager as root. Then navigate to /usr/share/applications

Find the application named Refracta Installer. Right-click on it, and open it with your text editor. Then, find the line --> NoDisplay=true

Place a # in front of that line (or delete it). Then close and save the file. That will make the Installer show in your menu. :)

To make your .iso smaller, you may consider running Bleachbit and Bleachbit (as root) before making your .iso. After running both applications, I would recommend that you reboot your computer before making your .iso.

Then, to make the .iso, open your terminal, become root (su or sudo), and enter the following command...

	refractasnapshot

...then follow the onscreen instructions. :)

HINT: Use your down arrow key to scroll down further if the information in the terminal goes to the bottom of the terminal.

			______________________________________________________________________________


SPECIAL ACKNOWLEDGMENTS

1. The font used for the MiyoLinux logo is called C.A. Gatintas, and the designer is deFharo. Though he didn't require any recognition for using the font, I felt like he deserved recognition for his work. I feel as though that font is a great representation of the MiyoLinux philosophy...so many thanks to deFharo for his work!

2. Thanks again to the developer of obmenu-generator!
	
3. My deepest thanks go out to both Devuan and fsmithred of Refracta. MiyoLinux wouldn't be possible without either of them.

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

4. Finally, my sincere thanks to anyone who may use MiyoLinux! I hope you enjoy it! :)
     
