MiyoLinux Release Notes Miyo-JWM 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". __________________________________________________________________________________ LIVE USER NOTES 1. Connecting to your wireless network 2. How to change the Keyboard Layout in the Live Session __________________________________________________________________________________ 1. Connecting to your wireless network Wired connections should connect automatically. If you need help connecting to a wireless network, here are basic instructions. a) You can click the globe icon located on the panel, or it can be accessed in the "Settings" category of the menu. Open the menu, and go to... Settings > Connman UI Setup b) When Connman UI Setup opens, click the Off button next to Wifi (that will turn on Wifi). c) Click the Wireless tab. d) Click 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 b. __________________________________________________________________________________ 2. How to change the Keyboard Layout in the Live Session a) You can click the keyboard icon located on the panel, or it can be accessed in the "System Accessories" category of the menu. b) Once the application opens, you can scroll through the list to find your keyboard layout. c) Click on your keyboard layout, and then click OK...the system will then temporarily adopt your layout. __________________________________________________________________________________ RELEASE NOTES This release is based on Debian 10 (buster). NOTES ON THIS RELEASE 1. JWM Menu 2. Theme Changer 3. Conky and the Conky Chooser 4. How to activate the firewall with UFW 5. Included the papirus-folders script to change Papirus folder colors 6. Startup Commands 7. Screenshots 8. MiyoLinux Update Notifier 9. Volume Icon 10. 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 11. Special Thanks and Acknowledgments ________________________________________________________________________________ 1. JWM Menu a) If you're unfamiliar with JWM, the menu not only has a launcher on the panel, but you can left-click anywhere on the desktop to bring up the menu also. b) The "applications" section of the menu is provided by xdgmenumaker. It will adopt the icon set that you choose in Customize Look and Feel. If you change icon sets, you must click on "Refresh Menu" for the applications portion of the menu to adopt the new icon theme. It will automatically add or remove any applications that you install (or remove); however, you must click on "Refresh Menu" for them to appear in (or be removed from) the menu. c) Everything outside of the applications section of the menu is hard-coded into the .jwmrc file(s). That includes the icons that are being used (which are Papirus icons). Those portions will not adopt the icon theme that you choose in Customize Look and Feel. If you want to change those icons (or have no icons), you will have to manually edit the .jwmrc file(s) and point to the icons that you want to use. ________________________________________________________________________________ 2. Theme Changer The theme changer will not automatically adopt any new themes (or edits) that you may create in your .jwmrc file(s). If you want to continue using the theme changer after editing the current .jwmrc file(s), you should replace the .jwmrc file(s) that are located in ~/.config/jwm/Dark-Theme/ or ~/.config/jwm/Light-Theme/ with the one(s) that you have edited or created from your Home folder. If you don't replace them with the ones that you have edited/created, your work will be lost the next time you use the theme changer. PLEASE NOTE: The Theme Changer only changes JWM. To make the rest of your system adopt the Dark or Light theme, you will need to use Customize Look and Feel. ________________________________________________________________________________ 3. Conky and the Conky Chooser In order for the conky to appear on computers that only have one CPU, I only have one CPU showing in the .conkyrc(s). If you have 2 CPUs, you can simply uncomment the second CPU for it to appear in the conky. If you have more than 2 CPUs, you will need to add them manually by editing the .conkyrc(s). a) Conky Chooser There are 6 conkys available in the Conky Chooser application. You will find it in the menu under... System Accessories > Conky Chooser b) WARNING! Before you edit the .conkyrc, make sure to note the name of the conky that you are going to edit. If you edit the .conkyrc file(s), and you want to have your edited version available in the Conky Chooser, you will have to copy the edited .conkyrc file from your Home folder, and paste it into the Conky's appropriate folder found in... ~/.config/conky/ ...each Conky's .conkyrc file is inside of the folder bearing its name. _______________________________________________________________________________ 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. 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. _______________________________________________________________________________ 6. Startup Commands Please read this section thoroughly if you're new to using JWM. Turning things on and off at startup will be different than what you're used to. The following items found in the System Accessories category of the menu can also be controlled through the Startup Commands section of the .jwmrc file(s)... Conky, Compton, and Touchpad The entries in the menu for those three items are only there for any temporary reason you may need them. The following items are available for you to turn on or off at system startup and are listed in order as they appear in the STARTUP COMMANDS portion of the .jwmrc file(s). The items in parenthesis are not starting up automatically... /usr/lib/policykit-1-gnome/polkit-gnome-authentication-agent-1 nitrogen power manager (touchpad controls) (number lock) (compton) conky volume icon (cmst) cmst is the network manager. Its system tray icon is not enabled at startup. Anything that is not running at startup is commented out in the .jwmrc file(s) by its command being enclosed with the following two sets of characters... To turn an item on so that it begins at startup, you must uncomment it. I will use Compton as an example. In the .jwmrc file(s), you will see the Startup Commands beginning at line 83. Compton is turned off by default at startup. So, if you wanted it to begin at startup, you would need to uncomment it. It is found on line 102 and looks like this... To have compton begin at startup, you would need to remove the characters on both sides of the command so that it will then look like this... compton After making the changes, save the file, close it, and the system will adopt the changes at next logout/login or reboot. To turn something off at startup, you will need to add those characters to both sides of the command. Do the same to any of the other items that you want to be on or off at system startup. WARNING: Please make sure to read the section about the Theme Changer if you want your startup changes to remain when changing themes. _______________________________________________________________________________ 7. Screenshots All screenshots will appear in your Pictures folder. _______________________________________________________________________________ 8. MiyoLinux Update Notifier After realizing that I was breaking one of my core beliefs by including something that a user may not want on their system, I decided not to include the MiyoLinux Update Notifier. However, I did leave it's line included in the Autostart section of the .jwmrc file(s) 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/ _______________________________________________________________________________ 9. VOLUME ICON Out of the box, when you left-click on the volume icon, it will mute the audio. To change it so that it will show the volume slider... a) Right-click on the volume icon, and choose Preferences. b) Click on Status Icon in the left side panel. c) Under Left Mouse Button Action, put a mark next to Show Slider. _______________________________________________________________________________ 10. 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, open the terminal, become root, and enter the following command... medit /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 _______________________________________________________________________________ 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 not carry over to the root account. To make the root account adopt the same changes, just open the menu, and go to... System Accessories > Customize Look and Feel (root account) 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. _______________________________________________________________________________ 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. It will only work if you set PCManFM to control your desktop. ______________________________________________________________________________ 11. 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...so many thanks to deFharo for his work! 2. I would also like to thank the developer of xdgmenumaker. WOW! What an incredible menu he has created! 3. Thanks to addy-fe for supplying the scripts for the "words of wisdom" that I included in the "Conversation" conky. 4. Many thanks to Adarsh Bhat...MiyoLinux advisor, idea knocker, and .iso tester extraordinaire! 5. Also, Many thanks go out to my friend eznix for his wonderful live-build tutorials. Thank you ez! 6. Thanks also to Jim Acklaw for helping point out some key issues while trying out the releases! Thanks Jim! 7. Finally, my sincere thanks to anyone who may use MiyoLinux! I hope you enjoy it!