MiyoLinux Release Notes Miyo-i3 was made so that users could have a minimal and base system on which to add the software and applications that they choose. It's up to the user to decide which applications they want on his/her system. Miyo is simply an acronym for "make it your own". The web browser, the music player, the office suite, the video player, etc. is left up to the user to install what he/she wants so that they can "make it their own". Miyo-i3 was also made to be an introductory i3 system for those who may be interesed in i3, but they have never tried it. The system is intended to be more user-friendly for new users out of the box. __________________________________________________________________________________ LIVE USER NOTES 1. Live username and password 2. Connecting to your wireless network 3. How to change the Keyboard Layout in the Live Session __________________________________________________________________________________ 1. Live username and password Username: user Password: live __________________________________________________________________________________ 2. Connecting to your wireless network a) Open dmenu (MOD + d) and search for Connman UI Setup, or open PMenu (MOD + m) and Connman UI Setup will be found in the Preferences category. b) When it opens, click the Off button next to Wifi (that will turn on Wifi). c) Click the Wireless tab. d) Click on the network that you want to connect to, then click the Connect button. e) Enter your network's Passphrase (password), then click OK. It should then connect to your network. You can make sure that it's connected by clicking the Status tab, and it should say whether it's connected or not next to the Wifi button that you clicked in step 2. __________________________________________________________________________________ 3. How to change the Keyboard Layout in the Live Session Open the Miyo-Accessories with Mod + Ctrl + A, and you can access the Live Keyboard layout from there. When it opens, scroll through the list to find your desired keyboard layout. Click on your keyboard layout, and then click OK, and the system will then temporarily adopt your layout. __________________________________________________________________________________ RELEASE NOTES This release is based on Debian 10 (buster). NOTES ON THIS RELEASE 1. i3 Application Menus - j4-dmenu-desktop - dmenu - Pmenu 2. How to change the MOD key. 3. How to activate the firewall with UFW 4. Included the papirus-folders script to change Papirus folder colors 5. Screenshots 6. MiyoLinux Update Notifier 7. Regarding the use of Compton. 8. Miscellaneous Notes - fix the sources.list - how to add yourself to sudo - change the root account themes and icons - zip, unzip, and tar are preinstalled - Desktop Preferences application - Keybinding for opening a web browser - Volume Control - Number lock 9. Special Thanks and Acknowledgments ________________________________________________________________________________ 1. i3 Application Menus There are three application menus available... a) j4-dmenu-desktop (Miyo-i3's default dmenu menu) b) dmenu c) Pmenu Depending on which version of dmenu you choose in the i3 config file, the keybind MOD + d will open it. a) The j4-dmenu-desktop menu is the default version of dmenu in Miyo-i3. It will only show the applications that are installed on your system. b) The classic dmenu is also available. It will show many more items and allow you to run scripts in addition to the applications that are installed on your system. If you prefer to use the regular dmenu, you will need to open the i3 config file and... 1) comment out the j4-dmenu-desktop line 2) uncomment the dmenu_run line 3) restart i3 with the keybind MOD + Shift + r c) Pmenu is a graphical dynamic menu application launcher that is similar to a regular desktop menu. The keybind for Pmenu is MOD + m. By default, Pmenu will appear where your mouse is located on the screen; however, an example is given (in the config file) to make it appear at a fixed point on your screen instead (if that is preferred). ________________________________________________________________________________ 2. How to change the MOD key Because there are some computers that don't have a Windows key, Miyo-i3 comes with the ALT key designated as the MOD key. If you would prefer to use the Windows key as the MOD key, just change it in the i3 configuration file. Towards the top of the file, you'll see this line... set $mod Mod1 To change it to the Windows key, change that line to this... set $mod Mod4 Save and close the file, then restart the i3 session with... MOD + Shift + r (You will still have to use the Alt key for that command, but the Windows key will become the MOD key after that) ________________________________________________________________________________ 3. 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 _______________________________________________________________________________ 4. Included the papirus-folders script to change Papirus folder colors The official papirus folders script is included in this release. If you would like to use a different color folder in the file manager, you can run the script to change the folder color. To use the script, open your terminal and enter the following command... papirus-folders -l ...that will list the available colors. After deciding which color you would like to use (I will use black as an example) enter the following command using sudo... sudo papirus-folders -C black The folders will adopt the new color the next time you open a new instance of the file manager. _______________________________________________________________________________ 5. Screenshots A full-screen screenshot can be made by pressing the Prtsc (Print Screen) key. Screenshots will appear in your Pictures folder. _______________________________________________________________________________ 6. MiyoLinux Update Notifier The MiyoLinux Update Notifier is not included out of the box. However, I did leave its line included in the Autostart section of the i3 config file to help anyone who may want to install it. If you would like to install it, there are three versions to choose from. In the readme file on Sourceforge, there is a brief description of how each one operates. The MiyoLinux Update Notifier(s) are available from the following link as .deb packages... https://sourceforge.net/projects/miyolinux/files/MiyoLinux-Update-Notifier/ _______________________________________________________________________________ 7. Regarding the use of Compton Compton is included in Miyo-i3. If you want to edit the configuration file for Compton, please make a backup of it before you do so. The use of Compton on i3 is very tricky. One wrong edit, and you may possibly make it unusable. _______________________________________________________________________________ 8. Miscellaneous Notes FIX THE SOURCES.LIST The first repository (buster) in the sources.list may only include main on some installations. If that happens and you want to add contrib and non-free, you will need to edit the sources.list manually or through the Synaptic Package Manager. To edit the sources.list via the terminal, open the terminal, become root, and enter the following command... mousepad /etc/apt/sources.list ..or... nano /etc/apt/sources.list You may also choose to add the backports repository. To include backports, add the following line to your sources.list... deb http://deb.debian.org/debian/ buster-backports main contrib non-free MAKE SURE TO RUN AN... apt update ...IF YOU DO ANY OF THE ABOVE. _______________________________________________________________________________ ADD YOURSELF TO SUDO (IF DESIRED) To add yourself to the sudoers file, open your terminal and enter the following commands one at a time (replace "your-username" with your actual username)... su -l /sbin/adduser your-username sudo ...you should then have sudo rights the next time you reboot your computer. _______________________________________________________________________________ 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 carry over to the root account. To make the root account adopt the same changes, open the Miyo-Accessories with MOD + Ctrl + a Click on Appearance (root account), enter your password in the authentication window, 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 (or however you would like the root account to appear). _______________________________________________________________________________ ZIP, UNZIP, AND TAR ARE PRE-INSTALLED If you haven't yet installed your preferred archive manager, and you need to create or open an archive...zip, unzip, and tar are pre-installed. ______________________________________________________________________________ DESKTOP PREFERENCES APPLICATION The Desktop Preferences application will not work. ______________________________________________________________________________ KEYBINDING FOR OPENING A WEB BROWSER Though there is no web browser installed, I do have MOD + b set to open x-www-browser. It will open whichever browser you install that the system designates as the x-www-browser. ______________________________________________________________________________ VOLUME CONTROL For users who may be new to i3, the volume is controlled by placing your mouse cursor over the volume indicator located on the bottom bar and scrolling the mouse wheel up or down. As an example, the volume control on the bar looks like this --> ♪ 45% ______________________________________________________________________________ NUMBER LOCK I didn't include the package "numlockx" in this release, because the Number lock is automatically enabled when the computer starts. If a user has an integrated number pad within the regular keyboard, that can pose problems...especially during installation. If you want to have your Number pad enabled automatically, you will need to install numlockx... apt install numlockx If you do install it, there is no need to add it to the autostart section of the i3 config file since it's enabled automatically. ______________________________________________________________________________ 9. SPECIAL THANKS AND 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...many thanks to deFharo for his work! 2. I would also like to thank the developer of Pmenu. WOW! What an incredible menu he has created! 3. Many thanks to Adarsh Bhat...MiyoLinux advisor, idea knocker, and .iso tester extraordinaire! 4. Also, Many thanks go out to my friend eznix for his wonderful live-build tutorials. Thank you ez! 5. Finally, my sincere thanks to anyone who may use MiyoLinux! I hope you enjoy it!