├── img ├── DNF-Dragora-2.png ├── DNF-Dragora-3.png ├── DNF-Dragora-4.png ├── DNF-Dragora-5.png ├── DNF-Dragora-6.png ├── DNF-Dragora-7.png ├── DNG-Dragora-1.png ├── Mate-Shortcuts.png ├── Xfce4-Terminal.png ├── liveusb-creator.jpg ├── BackInTime-Restore.png ├── LightDM-settings.png ├── Plasma-Shortcuts.png ├── Xfce-Panel-Switch.png ├── Xfce-Shortcuts-wm.png ├── BackInTime-Snapshots.png ├── Lightdm-Greeter-GTK.png ├── Xfce-Shortcuts-apps.png ├── BackInTime-Intro-Menu.png ├── BackInTime-Menu-Exclude.png ├── BackInTime-Menu-Include.png ├── DejaDup-Backups-In-Menu.png ├── DejaDup-Folders-To-Save.png ├── DejaDup-Revert-From-GUI.png ├── DejaDup-Scheduling-Menu.png ├── Lightdm-Greeter-Slick.png ├── Slick-Greeter-Settings.png ├── Slick-Greeter-settings1.png ├── Slick-Greeter-settings2.png ├── Slick-Greeter-settings3.png ├── liveusb-creator-windows.jpg ├── DejaDup-Backups-In-Search.png ├── DejaDup-Folders-To-Ignore.png ├── DejaDup-Show-Hidden-Files.png ├── BackInTime-Menu-Auto-Remove.png ├── Contibution-Guidelines-Fork.png ├── DejaDup-Schedule-Frequency.png ├── install-oracle-java-download.jpg ├── install-oracle-java-select.jpg ├── liveusb-creator-windows-admin.jpg ├── DejaDup-Restore-Missing-From-GUI.png ├── cinnamon-keyboard_shortcuts_window.png ├── generic-laptop-korora-gnome-desktop.png ├── GRUB_2_configuration_and_customisation.png └── Korora_Project_-_2017-06-14_22.18.13.png ├── README.md ├── UsingKorora ├── Tips-And-Tricks.md ├── DesktopSpecific │ ├── Updating-Xfce.md │ ├── Gnome.md │ ├── Autologin-In-Xfce.md │ ├── Autologin-In-Cinnamon.md │ ├── KDE-Plasma.md │ ├── Autologin-In-Mate.md │ ├── Mate.md │ ├── Xfce-Panel-Switch.md │ ├── Cinnamon.md │ ├── Xfce.md │ ├── Autologin-In-KDE-Plasma.md │ ├── Desktop-Specific.md │ ├── Xfce-Terminal.md │ ├── Mate-Shortcuts.md │ ├── Xfce-Shortcuts.md │ ├── Xfce-Tour-of-Software.md │ ├── Cinnamon-Tour-of-Software.md │ ├── GNOME-Tour-of-Software.md │ ├── MATE-Tour-of-Software.md │ └── KDE-Tour-of-Software.md ├── Automatically-Unlock-the-Keyring-when-Logging-In.md ├── Updating-Korora.md ├── General │ ├── Installing-Skype.md │ ├── Sudo.md │ ├── Installing-Chromium-Browser.md │ ├── Solving-Audio-Issues.md │ ├── General.md │ ├── Installing-Spotify.md │ ├── Installing-Google-Chrome.md │ ├── Tour-of-Korora-Software.md │ ├── Accessing-Text-Console.md │ ├── Pulse-Audio.md │ ├── Installing-Oracle-Java.md │ ├── Qt-Theming.md │ └── Installing-Other-Desktops.md ├── hibernation.md ├── Bootloader.md ├── LightDM.md ├── Updating-Via-Command-Line.md ├── Updating-With-Yumex.md ├── Keeping-Current-Package-Versions.md ├── Upgrading-Known-Issues.md ├── LightDM-Greeter-Settings.md ├── Autologin-in-LightDM.md ├── Screen-Locking-with-Light-Locker.md ├── Upgrading-Korora.md ├── changing-the-lightdm-greeter.md ├── Slick-Greeter-Settings.md ├── How-to-Install-and-Run-Virtualbox.md ├── dnfdragora.md ├── Using-Korora.md └── Working-With-Archives.md ├── Home.md ├── _Footer.md ├── GettingKorora ├── Korora-Install-How-To.md ├── Getting-Korora.md ├── Which-Desktop-for-Your-Korora.md └── Installing-Korora.md ├── DevelopingKorora ├── Developing-For-Korora.md ├── codenames.md ├── Iso-Testing.md ├── Contributing-To-Documentation.md ├── Planned-Documentation.md ├── Contribution-Guidelines.md ├── building-isos-with-canvas.md └── Using-Kp.md ├── GettingHelp ├── Troubleshooting-Tips.md ├── Fpaste.md ├── Getting-Help-With-Korora.md └── Using-Engage.md ├── Development-Notes.md └── _Sidebar.md /img/DNF-Dragora-2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNF-Dragora-2.png -------------------------------------------------------------------------------- /img/DNF-Dragora-3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNF-Dragora-3.png -------------------------------------------------------------------------------- /img/DNF-Dragora-4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNF-Dragora-4.png -------------------------------------------------------------------------------- /img/DNF-Dragora-5.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNF-Dragora-5.png -------------------------------------------------------------------------------- /img/DNF-Dragora-6.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNF-Dragora-6.png -------------------------------------------------------------------------------- /img/DNF-Dragora-7.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNF-Dragora-7.png -------------------------------------------------------------------------------- /img/DNG-Dragora-1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DNG-Dragora-1.png -------------------------------------------------------------------------------- /img/Mate-Shortcuts.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Mate-Shortcuts.png -------------------------------------------------------------------------------- /img/Xfce4-Terminal.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Xfce4-Terminal.png -------------------------------------------------------------------------------- /img/liveusb-creator.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/liveusb-creator.jpg -------------------------------------------------------------------------------- /img/BackInTime-Restore.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/BackInTime-Restore.png -------------------------------------------------------------------------------- /img/LightDM-settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/LightDM-settings.png -------------------------------------------------------------------------------- /img/Plasma-Shortcuts.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Plasma-Shortcuts.png -------------------------------------------------------------------------------- /img/Xfce-Panel-Switch.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Xfce-Panel-Switch.png -------------------------------------------------------------------------------- /img/Xfce-Shortcuts-wm.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Xfce-Shortcuts-wm.png -------------------------------------------------------------------------------- /img/BackInTime-Snapshots.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/BackInTime-Snapshots.png -------------------------------------------------------------------------------- /img/Lightdm-Greeter-GTK.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Lightdm-Greeter-GTK.png -------------------------------------------------------------------------------- /img/Xfce-Shortcuts-apps.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Xfce-Shortcuts-apps.png -------------------------------------------------------------------------------- /img/BackInTime-Intro-Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/BackInTime-Intro-Menu.png -------------------------------------------------------------------------------- /img/BackInTime-Menu-Exclude.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/BackInTime-Menu-Exclude.png -------------------------------------------------------------------------------- /img/BackInTime-Menu-Include.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/BackInTime-Menu-Include.png -------------------------------------------------------------------------------- /img/DejaDup-Backups-In-Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Backups-In-Menu.png -------------------------------------------------------------------------------- /img/DejaDup-Folders-To-Save.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Folders-To-Save.png -------------------------------------------------------------------------------- /img/DejaDup-Revert-From-GUI.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Revert-From-GUI.png -------------------------------------------------------------------------------- /img/DejaDup-Scheduling-Menu.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Scheduling-Menu.png -------------------------------------------------------------------------------- /img/Lightdm-Greeter-Slick.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Lightdm-Greeter-Slick.png -------------------------------------------------------------------------------- /img/Slick-Greeter-Settings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Slick-Greeter-Settings.png -------------------------------------------------------------------------------- /img/Slick-Greeter-settings1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Slick-Greeter-settings1.png -------------------------------------------------------------------------------- /img/Slick-Greeter-settings2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Slick-Greeter-settings2.png -------------------------------------------------------------------------------- /img/Slick-Greeter-settings3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Slick-Greeter-settings3.png -------------------------------------------------------------------------------- /img/liveusb-creator-windows.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/liveusb-creator-windows.jpg -------------------------------------------------------------------------------- /img/DejaDup-Backups-In-Search.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Backups-In-Search.png -------------------------------------------------------------------------------- /img/DejaDup-Folders-To-Ignore.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Folders-To-Ignore.png -------------------------------------------------------------------------------- /img/DejaDup-Show-Hidden-Files.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Show-Hidden-Files.png -------------------------------------------------------------------------------- /img/BackInTime-Menu-Auto-Remove.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/BackInTime-Menu-Auto-Remove.png -------------------------------------------------------------------------------- /img/Contibution-Guidelines-Fork.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Contibution-Guidelines-Fork.png -------------------------------------------------------------------------------- /img/DejaDup-Schedule-Frequency.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Schedule-Frequency.png -------------------------------------------------------------------------------- /img/install-oracle-java-download.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/install-oracle-java-download.jpg -------------------------------------------------------------------------------- /img/install-oracle-java-select.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/install-oracle-java-select.jpg -------------------------------------------------------------------------------- /img/liveusb-creator-windows-admin.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/liveusb-creator-windows-admin.jpg -------------------------------------------------------------------------------- /img/DejaDup-Restore-Missing-From-GUI.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/DejaDup-Restore-Missing-From-GUI.png -------------------------------------------------------------------------------- /img/cinnamon-keyboard_shortcuts_window.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/cinnamon-keyboard_shortcuts_window.png -------------------------------------------------------------------------------- /img/generic-laptop-korora-gnome-desktop.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/generic-laptop-korora-gnome-desktop.png -------------------------------------------------------------------------------- /img/GRUB_2_configuration_and_customisation.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/GRUB_2_configuration_and_customisation.png -------------------------------------------------------------------------------- /img/Korora_Project_-_2017-06-14_22.18.13.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/kororaproject/kp-documentation/HEAD/img/Korora_Project_-_2017-06-14_22.18.13.png -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [kp-documentation](#kp-documentation) 6 | 7 | 8 | 9 | 10 | # kp-documentation 11 | Documentation for all of Korora 12 | -------------------------------------------------------------------------------- /UsingKorora/Tips-And-Tricks.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Tips and Tricks](#tips-and-tricks) 6 | 7 | 8 | 9 | 10 | # Tips and Tricks 11 | 12 | Here you'll find some tips and details on how to tweak your system. 13 | -------------------------------------------------------------------------------- /Home.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Documentation. The Guides](#documentation-the-guides) 6 | 7 | 8 | 9 | 10 | # Documentation. The Guides 11 | This section is under development. 12 | The current documentation may be found at . 13 | 14 | ![](img/generic-laptop-korora-gnome-desktop.png) 15 | -------------------------------------------------------------------------------- /_Footer.md: -------------------------------------------------------------------------------- 1 | Derived from [Fedora](https://getfedora.org/) | Powered by [Freedaom](https://en.wiktionary.org/wiki/freedom), [Dedication](https://en.wiktionary.org/wiki/dedication) and the pursuit of [Perfection](https://en.wiktionary.org/wiki/freedom) 2 | 3 | All published content is licensed under the [CC‑BY‑SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) International license. -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Updating-Xfce.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Updating Xfce](#updating-xfce) 6 | 7 | 8 | 9 | 10 | # Updating Xfce 11 | 12 | The Xfce desktop can be updated using a graphical package manager or by using the [command line](https://github.com/kororaproject/kp-documentation/wiki/Updating-Via-command-Line). 13 | 14 | The default GUI in Xfce is the [Yum Extender, Yumex](https://github.com/kororaproject/kp-documentation/wiki/Updating-With-Yumex). 15 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Gnome.md: -------------------------------------------------------------------------------- 1 | GNOME's new desktop takes elegance to a new level. They've swept away the clutter and made a simple and easy-to-use desktop that's the most beautiful version ever that includes a new visual theme, a refined new font and carefully crafted animations. We have taken the solid base and have applied additional polish to provide a unique Korora flavour. This section will help you get the best out of Gnome in Korora. 2 | 3 | **Gnome Guides** 4 | 5 | - [Tour of Gnome Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-gnome-software-i-need-a-program-that-does-this) 6 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Autologin-In-Xfce.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Autologin in Xfce](#autologin-in-xfce) 6 | 7 | 8 | 9 | 10 | # Autologin in Xfce 11 | 12 | When you start your Korora system it takes you to the LightDM so you can enter your password and start Xfce. However if you are the only user of the system you may prefer to bypass this screen and have Korora go straight to the desktop. 13 | 14 | As Xfce uses LightDM as the default Display Manager see the [Autologin In LightDM documentation page](https://github.com/kororaproject/kp-documentation/wiki/Autologin-in-LightDM) to configure Autologin. 15 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Autologin-In-Cinnamon.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Autologin in Cinnamon](#autologin-in-cinnamon) 6 | 7 | 8 | 9 | 10 | # Autologin in Cinnamon 11 | 12 | When you start your Korora system it takes you to the LightDM so you can enter your password and start Cinnamon. However if you are the only user of the system you may prefer to bypass this screen and have Korora go straight to the desktop. 13 | 14 | As Cinnamon uses LightDM as the default Display Manager see the [Autologin In LightDM documentation page](https://github.com/kororaproject/kp-documentation/wiki/Autologin-in-LightDM) to configure Autologin. 15 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/KDE-Plasma.md: -------------------------------------------------------------------------------- 1 | KDE Plasma is desktop environment that is designed to provide a highly configurable interface. It has several unique features and probably the most comprehensive Settings of all the desktops. Using visual effects and scaleable graphics, the desktop experience is not only smooth but also pleasing to the eye. Getting best out of Plasma takes time and experimentation. 2 | 3 | **KDE Plasma Guides** 4 | 5 | - [Autologin in KDE Plasma](https://kororaproject.org/support/documentation/autologin-in-kde-plasma) 6 | - [Tour of KDE Plasma Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-kde-plasma-software-i-need-a-program-that-does-this) 7 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Autologin-In-Mate.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Autologin in Mate](#autologin-in-mate) 6 | 7 | 8 | 9 | 10 | # Autologin in Mate 11 | 12 | When you start your Korora system it takes you to the LightDM so you can enter your password and start Mate. However if you are the only user of the system you may prefer to bypass this screen and have Korora go straight to the desktop. 13 | 14 | As Mate uses LightDM as the default Display Manager see the [Autologin In LightDM documentation page](https://github.com/kororaproject/kp-documentation/wiki/Autologin-in-LightDM) to configure Autologin. Please note the additional section specific to Mate at the end of that guide. 15 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Mate.md: -------------------------------------------------------------------------------- 1 | Mate is a fork of the much loved Gnome 2 but uses the modern backend of GTK3 for a stable, modern and configurable yet traditional desktop. The guides in this section will show you how get the best out of Mate. 2 | 3 | Mate uses LightDM as its Display Manger. To configure and customise LightDM see also note the additional section for Mate at the end of that guide. 4 | 5 | 6 | **Mate Guides** 7 | 8 | - [Autologin in Mate](https://kororaproject.org/support/documentation/autologin-in-mate) 9 | - [Mate Shortcuts](https://kororaproject.org/support/documentation/mate-shortcuts) 10 | - [Tour of Mate Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-mate-software-i-need-a-program-that-does-this) 11 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Xfce-Panel-Switch.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Xfce Panel Switch](#xfce-panel-switch) 6 | 7 | 8 | 9 | 10 | # Xfce Panel Switch 11 | 12 | Korora includes a useful utility that is hidden at the end of the Settings Menu, Xfce Panel Switch. As the name suggests it provides a facility to switch panel settings as you work. It also provides a backup facility. 13 | 14 | ![](https://github.com/kororaproject/kp-documentation/wiki/img/Xfce-Panel-Switch.png) 15 | 16 | Xfce Panel Switch xfpanel-switch is a simple utility that can back up and restore your panel configuration. It includes a couple of different configs you can try out but use its "Save Configuration" option to backup your set up first. 17 | 18 | It can also be used to preserve your existing setup while you experiment with some new configurations. 19 | -------------------------------------------------------------------------------- /GettingKorora/Korora-Install-How-To.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installing Korora - Video Guide](#installing-korora---video-guide) 6 | 7 | 8 | 9 | 10 | # Installing Korora - Video Guide 11 | 12 | Being a Fedora Remix, Korora inherits the [Anaconda ](https://fedoraproject.org/wiki/Anaconda)installer for all of our images. Having undergone a massive re-write in 2012 it has seen solid improvements since then. This presentation walks you through the installation of Korora onto your hard disk and although it was created for version 18, it is still relevant for the latest release. 13 | 14 | You may need to add `vimeo.com `to the FlashBlock extension's whitelist before the video will play in FireFox. 15 | 16 | [![img/Korora_Project_-_2017-06-14_22.18.13.png](img/Korora_Project_-_2017-06-14_22.18.13.png)](https://vimeo.com/69508041) 17 | -------------------------------------------------------------------------------- /DevelopingKorora/Developing-For-Korora.md: -------------------------------------------------------------------------------- 1 | There are a number of ways you can assist the Korora Project. There are options for people of all skills levels. See [our contribute page](https://kororaproject.org/contribute) for more details Details on how to build for Korora coming soon! 2 | 3 | **Document List** 4 | - [Contributing to Documentation](https://kororaproject.org/support/documentation/contributing-to-documentation) 5 | - [Contribution Guidelines](https://kororaproject.org/support/documentation/contribution-guidelines) 6 | - [Planned Documentation](https://kororaproject.org/support/documentation/planned-documentation) 7 | - [ISO Testing](https://kororaproject.org/support/documentation/iso-testing) 8 | - [Korora Version History](https://kororaproject.org/support/documentation/korora-codenames) 9 | - [Using the Korora Packaging Tool, KP](https://kororaproject.org/support/documentation/using-kp) 10 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Cinnamon.md: -------------------------------------------------------------------------------- 1 | Cinnamon is built on top of core GNOME technologies like GTK and Clutter yet provides a more traditional desktop while still including modern advanced features. More akin to KDE and unlike GNOME, it is designed to be very flexible and configurable. The guides in this section will show you how get the best out of Cinnamon. 2 | 3 | Cinnamon uses LightDM as its Display Manger. To configure and customise LightDM see the [LightDM](https://kororaproject.org/support/documentation/lightdm) guide. 4 | 5 | **Cinnamon Guides** 6 | 7 | - [Autologin in Cinnamon](https://kororaproject.org/support/documentation/autologin-in-cinnamon) 8 | - [Cinnamon Shortcuts](https://kororaproject.org/support/documentation/cinnamon-shortcuts) 9 | - [Tour of Cinnamon Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-cinnamon-software-i-need-a-program-that-does-this) 10 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Xfce.md: -------------------------------------------------------------------------------- 1 | Xfce is a light but highly configurable Desktop Environment. It is popular with many people who prefer a simple and traditional desktop experience. 2 | 3 | Xfce uses LightDM as its Display Manger. To configure and customise LightDM see . 4 | 5 | 6 | **Xfce Guides** 7 | 8 | - [Autologin in Xfce](https://kororaproject.org/support/documentation/autologin-in-xfce) 9 | - [Tour of Xfce Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-xfce-software-i-need-a-program-that-does-this) 10 | - [Updating Xfce](https://kororaproject.org/support/documentation/updating-xfce) 11 | - [Xfce Panel Switch](https://kororaproject.org/support/documentation/xfce-panel-switch) 12 | - [Xfce Shortcuts](https://kororaproject.org/support/documentation/xfce-shortcuts) 13 | - [Xfce Terminal Dropdown Option](https://kororaproject.org/support/documentation/xfce-terminal) 14 | -------------------------------------------------------------------------------- /UsingKorora/Automatically-Unlock-the-Keyring-when-Logging-In.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Auto-unlock](#auto-unlock) 6 | 7 | 8 | 9 | LightDM is the default display manager in Korora for Cinnamon, MATE and Xfce. When you start your Korora system it takes you to the LightDM so you can enter your password. However, after logging in you will be asked to enter a password for your Keyring. if you use your user password as the keyring password LightDM can automatically unlock the keyring for you. 10 | >It is always a good idea to backup any important data before modifying system configuration. 11 | 12 | 13 | ### Auto-unlock 14 | It is possible to set LightDM to automatically unlock your keyring when you log in. 15 | 16 | Using your preferred text editor open /etc/pam.d/lightdm. You will need root permission to edit this file so use `su -` or prefix the command with `sudo`. Uncomment, by removing the leading `-` from, the following line: 17 | ```bash 18 | -auth optional pam_gnome_keyring.so 19 | ``` -------------------------------------------------------------------------------- /UsingKorora/Updating-Korora.md: -------------------------------------------------------------------------------- 1 | Korora regularly provides updates to the packages that make up the system. These include security updates, bug fixes or newer versions of software. All systems should be updated regularly to ensure the system operates in the most efficient and secure manner possible. 2 | 3 | There are a number of ways updates can be installed. All Korora come with a graphical package manager or updates can be installed from the command line. The recommended methods of update are by [Yumex](https://github.com/kororaproject/kp-documentation/wiki/Updating-With-Yumex) or the [command line](https://github.com/kororaproject/kp-documentation/wiki/Updating-Via-command-Line). 4 | 5 | **Document List** 6 | 7 | - [Keeping Current Package Versions](https://kororaproject.org/support/documentation/keeping-current-package-versions) 8 | - [Updating via Command Line](https://kororaproject.org/support/documentation/updating-via-command-line) 9 | - [Updating with Yumex](https://kororaproject.org/support/documentation/updating-with-yumex) 10 | -------------------------------------------------------------------------------- /UsingKorora/General/Installing-Skype.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installing Skype](#installing-skype) 6 | 7 | 8 | 9 | 10 | # Installing Skype 11 | 12 | Skype is a popular messaging and telephony client. It isn't open source and the license prohibits redistribution however it is possible to install it using Korora's package manager or from the command line using dnf. 13 | 14 | The RPMFusion repository provides a Local Package Factory package that downloads and installs Skype and its required dependencies. Skype is only available as a i686 package but will run on 64 bit systems. 15 | 16 | To install type 17 | 18 | ``` 19 | sudo dnf install lpf-skype 20 | ``` 21 | 22 | When it is installed run lpf-skype from the menu. It will handle the download and installation of Skype. Just follow the instructions on the screen. You will be asked for your password to authorise installation and also need to click OK in a confirmation screen. 23 | 24 | When it is complete Skype will appear on the Internet section of your menu. 25 | -------------------------------------------------------------------------------- /UsingKorora/hibernation.md: -------------------------------------------------------------------------------- 1 | Hibernation is the ability to pause your Korora system and resume exactly where you were at a later time. Unlike Suspend which needs power Hibernation requires no power and so can be resumed at any future tme. 2 | 3 | Suspend will use the computer's memory to retain the session information. This has the advantage of being much faster, almost intantanneous. However is power is lost the session is lost too. Hibernation uses the swap partition to save the session information and so will retain that information indefinitely. 4 | 5 | By default hibernation is not set to be operational on Korora systems. It needs to be configured in the boot options by defing a resume device. This is your swap partition. 6 | 7 | To set a resume device you need to add `resume=/dev/sdxn` to /etc/default/grub (changing the x and n to the correct device for the swap partition). Then run `grub2-mkconfig -o /boot/grub2/grub.cfg` (or if on an efi system /boot/efi/EFI/fedora/grub.cfg, if not sure use command completion to show the correct path). Use sudo or run this command as root. 8 | -------------------------------------------------------------------------------- /UsingKorora/Bootloader.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | The bootloader is the application that starts your computer. Typically, if you have multiple system installed, it will give you the option of the operating system to run and my offer options on how the start the system such as the kernel to use. 4 | 5 | **Document List** 6 | - [Grub 2 Configuration Customisation](https://kororaproject.org/support/documentation/grub-2-configuration-customisation) 7 | - [LightDM](https://kororaproject.org/support/documentation/lightdm) 8 | - [Autologin in LightDM](https://kororaproject.org/support/documentation/autologin-in-lightdm) 9 | - [Automatically Unlock The Keyring when Logging In](https://kororaproject.org/support/documentation/automatically-unlock-the-keyring-when-logging-in) 10 | - [Changing the LightDM Greeter](https://kororaproject.org/support/documentation/changing-the-lightdm-greeter) 11 | - [LightDM GTK+ Greeter Settings](https://kororaproject.org/support/documentation/lightdm-greeter-settings) 12 | - [Screen Locking with Light Locker](https://kororaproject.org/support/documentation/screen-locking-with-light-locker) 13 | - [Slick Greeter Settings](https://kororaproject.org/support/documentation/slick-greeter-settings) 14 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Autologin-In-KDE-Plasma.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Autologin in KDE Plasma](#autologin-in-kde-plasma) 6 | - [Autologin](#autologin) 7 | 8 | 9 | 10 | 11 | # Autologin in KDE Plasma 12 | 13 | When you start your Korora system it takes you to the SDDM so you can enter your password and start Plasma. However if you are the only user of the system you may prefer to bypass this screen and have Korora go straight to the desktop. 14 | 15 | >It is always a good idea to backup any important data before modifying system configuration. 16 | 17 | 18 | ## Autologin 19 | 20 | It is possible to set SDDM to log in to the default user without asking for a password. 21 | 22 | >Autologin reduces the security of the system as anyone starting the system can access the default user's data without knowledge of the password. It should not be enabled without consideration of the security implications. 23 | 24 | KDE provides a graphical setting screen for SDDM. Start "System Settings" and select "Startup and Shutdown". The first option is for SDDM. Select the Advanced tab. Check the Autologin box and confirm the correct user and session are shown. Click on Apply. KDE will now automatically start Plasma and log in the selected user. 25 | -------------------------------------------------------------------------------- /UsingKorora/LightDM.md: -------------------------------------------------------------------------------- 1 | The Display Manager provides the graphical login screen you see when you start your Korora system. It has options for the desktop you will run and allows you to enter your password. Korora uses LightDM as the display manager for Cinnamon, Mate and Xfce. These guides will show you how to customise LightDM up to suit your specific needs. 2 | 3 | Korora includes a graphical configuration utility for LightDM. You will find it in System Settings or under Administration depending on the Desktop Environment you are using. It allows the setting of background, theme, user icon. location and a number of other options. 4 | 5 | **Document List** 6 | 7 | - [Autologin in LightDM](https://kororaproject.org/support/documentation/autologin-in-lightdm) 8 | - [Automatically Unlock The Keyring when Logging In](https://kororaproject.org/support/documentation/automatically-unlock-the-keyring-when-logging-in) 9 | - [Changing the LightDM Greeter](https://kororaproject.org/support/documentation/changing-the-lightdm-greeter) 10 | - [LightDM GTK+ Greeter Settings](https://kororaproject.org/support/documentation/lightdm-greeter-settings) 11 | - [Screen Locking with Light Locker](https://kororaproject.org/support/documentation/screen-locking-with-light-locker) 12 | - [Slick Greeter Settings](https://kororaproject.org/support/documentation/slick-greeter-settings) 13 | -------------------------------------------------------------------------------- /UsingKorora/General/Sudo.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Sudo](#sudo) 6 | - [Setting up Sudo](#setting-up-sudo) 7 | - [Using Sudo](#using-sudo) 8 | 9 | 10 | 11 | 12 | # Sudo 13 | 14 | Prefacing a command with sudo allows a user to run that command as another user. It is commonly used to run commands, such as dnf, that require administrator permission as a user. 15 | 16 | 17 | ## Setting up Sudo 18 | In Korora Sudo is normally set up during the installation of the system by selecting the Administrator option when creating the user. However it can easily by created after installation. In a terminal run (replacing 'username' with the username of the user). 19 | 20 | ``` 21 | su -c "usermod -g wheel username" 22 | ``` 23 | 24 | You will be asked for the root password. 25 | 26 | 27 | ## Using Sudo 28 | 29 | Commands that require authentication can now be run by prefacing them with sudo. When asked for the password enter the user's password. With applications that request authentication it is the user password that is required. 30 | 31 | It is still possible to open a root shell by entering `su - ` in a terminal and typing the root password when asked. 32 | 33 | For further information see [https://fedoramagazine.org/howto-use-sudo](https://fedoramagazine.org/howto-use-sudo)/. 34 | -------------------------------------------------------------------------------- /UsingKorora/General/Installing-Chromium-Browser.md: -------------------------------------------------------------------------------- 1 | Installing Chromium Browser 2 | 3 | While Firefox has always been the default browser in Korora many people like to add another browser. One of the most popular ones is [Google's Chrome](https://kororaproject.org/support/documentation/installing-google-chrome) browser. However Chrome also has an opensource sibling, **Chromium**, which is now in the repos. That means it is easy to add to Korora. 4 | 5 | Chromium looks and works the same as Chrome however it is often a version or 2 behind. It is a popular option for those who want something different to Firefox but still want to use open source. 6 | 7 | ### Installation 8 | As Chromium is in the repos it is simple to install. A simple `sudo dnf install chromium` will install the browser and the required libs packages. 9 | 10 | However the standard chromium-libs-media package does not include all the available codecs etc. required for many websites. Fortunately an extended version, **chromium-lib-media-freeworld** is available from RPMFusion. This includes the extra libs needed as well as those included in the standard package. It is fine to have both packages installed together however only the freeworld version is needed. 11 | 12 | As the RPMFusion repo is already active in Korora, Chromium can be installed complete with the extended Meda libs with `sudo dnf install chromium chromium-libs-media-freeworld`. Alternatively you can search for both packages in your preferred Package Manager. -------------------------------------------------------------------------------- /UsingKorora/Updating-Via-Command-Line.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Updating via command line](#updating-via-command-line) 6 | 7 | 8 | 9 | 10 | ## Updating via command line 11 | 12 | Korora has a command line which is extremely powerful and flexible. Learning how to use it is something that all good Linux users should be able to do without being scared. Here's how to update your system using the command line. 13 | 14 | While you can use a GUI to update your system, many users prefer the command line because it's more lightweight and easier to see what's going on and can easily be scheduled. 15 | 16 | The primary package management tool is _dnf_ which can not only install and remove packages but update your entire system. 17 | 18 | Open up a terminal and become root. 19 | 20 | ``` 21 | sudo -i 22 | ``` 23 | 24 | If you want to, you can clean local metadata and force an update from the remote servers, but this isn't necessary as the --refresh option does much the same. 25 | 26 | ``` 27 | dnf clean all 28 | ``` 29 | 30 | Update all packages. 31 | 32 | ``` 33 | dnf --refresh upgrade 34 | ``` 35 | 36 | > If you need to restart the update, e.g. when a package fails to download, remove the --refresh option from the command 37 | 38 | 39 | 40 | >If the update included a new kernel or other major system package you should reboot the system. If a new version of your desktop environment has been provided you should log out and back in. 41 | -------------------------------------------------------------------------------- /UsingKorora/General/Solving-Audio-Issues.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Solving Audio Issues](#solving-audio-issues) 6 | 7 | 8 | 9 | 10 | # Solving Audio Issues 11 | 12 | Most audio issues are easily solved using the installed tools in Korora. Common audio issues include no sound and sound not playing on the desired output device. The included tools include the PulseAudio Volume Control which is used to solve most issues. Also included are the command line Alsamixer and possibly a desktop environment’s own mixer. However these are rarely needed. 13 | 14 | Occasionally audio applications may provide their own audio controls so check the application settings and if possible also test with another application. If the issue is limited to a single application try running it from a terminal and watch for error messages. 15 | 16 | When there is any audio issue the first thing to check is that the correct output is selected. Then check that it isn’t muted. These are set on the Configuration and Output tabs of PulseAudio Volume Control. 17 | 18 | There may be a panel plugin that controls this but it will just be a front end for the PulseAudio Volume Control which you will find on the Multimedia section of the menu. See here for more information on [PulseAudio Volume Control](https://github.com/kororaproject/kp-documentation/wiki/Pulse-Audio). 19 | 20 | If you have a different issue or can’t solve your issue please ask on [Engage](https://kororaproject.org/support/engage). 21 | -------------------------------------------------------------------------------- /UsingKorora/General/General.md: -------------------------------------------------------------------------------- 1 | These tips should work on all Korora systems. 2 | 3 | **Document List** 4 | 5 | - [Accessing a Text Console](https://kororaproject.org/support/documentation/accessing-a-text-console) 6 | - [How to Backup Your System](https://kororaproject.org/support/documentation/how-to-backup-your-system) 7 | - [Back in Time](https://kororaproject.org/support/documentation/back-in-time) 8 | - [Déjà Dup](https://kororaproject.org/support/documentation/deja-dup) 9 | - [Installing Google Chrome](https://kororaproject.org/support/documentation/installing-google-chrome) 10 | - [Installing Oracle's Java](https://kororaproject.org/support/documentation/installing-oracles-java) 11 | - [Installing Other Desktops](https://kororaproject.org/support/documentation/installing-other-desktops) 12 | - [Installing Skype](https://kororaproject.org/support/documentation/installing-skype) 13 | - [PulseAudio Volume Control (pavucontrol)](https://kororaproject.org/support/documentation/pulseaudio-volume-control-pavucontrol) 14 | - [QT Theming on GTK Desktops](https://kororaproject.org/support/documentation/qt-theming) 15 | - [Solving Audio Issues](https://kororaproject.org/support/documentation/solving-audio-issues) 16 | - [Sudo](https://kororaproject.org/support/documentation/sudo) 17 | - [Tour of Korora Software ("I Need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-korora-software-i-need-a-program-that-does-this) 18 | - [Working with Archives](https://kororaproject.org/support/documentation/working-with-archives) 19 | -------------------------------------------------------------------------------- /GettingHelp/Troubleshooting-Tips.md: -------------------------------------------------------------------------------- 1 | Before asking for help there are a few things you can do to solve the problem yourself. Even if they don't completely fix the issue the information gathered will help anyone providing support to you. 2 | 3 | 1. Is the problem consistent? Does it recur in a regular manner, can it be reproduced on demand? When did it first occur? 4 | 5 | 2. If you have problems with an application run it from a terminal and note any errors and messages. Check help, is there a log file or a log option? 6 | 7 | 3. Is the system up to date? Did the problem first occur after a recent update? Review the update for any associated packages. 8 | 9 | 1. Create a new user and test again. Does problem exist when run as a different user? If no then it is a configuration issue. 10 | 11 | 1. Check preferences, e.g. some applications have an option to use system defaults or its own setup. 12 | 13 | 1. If the system has an alternate application does the problem still occur? e.g. if playing media is an issue try with another media player. 14 | 15 | 1. If searching the internet for help search for Fedora as well as Korora. 16 | 17 | 2. If using Gnome test under both Xorg and Wayland logins. 18 | 19 | If these tips don't help you solve the issue please search [Engage](https://kororaproject.org/support/engage) for a similar problem and if there are none, start a new thread. In the thread detail the steps you have taken and the results. Also provide your basic system details such as version of Korora, the Desktop Environment you are using and any applicable hardware . -------------------------------------------------------------------------------- /UsingKorora/General/Installing-Spotify.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Installing Spotify](#installing-spotify) 4 | - [Updating Spotify](#updating-spotify) 5 | 6 | 7 | 8 | # Installing Spotify 9 | 10 | Spotify is a popular streaming service and provides a client to access the service. It isn't open source and the license prohibits redistribution however it is possible to install it using Korora's package manager or from the command line using dnf. You will need to create a Spotify account to use this application. 11 | 12 | The RPMFusion repository provides a Local Package Factory package that downloads and installs Spotify and its required dependencies. 13 | 14 | To install type 15 | ``` 16 | sudo dnf install lpf-spotify-client 17 | ``` 18 | When it is installed run lpf-spotify-client from the menu. Depending on the desktop environment you use it will appear in the System or similar area. It will handle the download and installation of Spotify. Just follow the instructions on the screen. You will be asked for your password to authorise installation and also need to click OK in a confirmation screen to accept licence terms. 19 | 20 | When it is complete Spotify Client will appear on the Multimedia section of your menu. You can create a new Spotify account or sign in with an existing account. 21 | 22 | 23 | # Updating Spotify 24 | 25 | When a new version of Spotify client is released you can update by running lpf-spotify-client from the menu again. It will recognise that a new version is available and repeat the download, build and install process for you. 26 | -------------------------------------------------------------------------------- /DevelopingKorora/codenames.md: -------------------------------------------------------------------------------- 1 | # Korora Version History 2 | 3 | Korora(a) release are given codenames are based on characters from Finding Nemo. There has been one exception and one shared name as noted below. 4 | 5 | The desktop environment options do change from time to time. 6 | 7 | ``` 8 | Version Release Date Codename Desktops 9 | Kororaa 14 2011-05-31 Nemo KDE 10 | Kororaa 15 2011-09-20 Squirt KDE Gnome 11 | Kororaa 15.1 2011-10-20 KDE Gnome 12 | Kororaa 16 2011-12-16 Chum KDE Gnome 13 | Kororaa 17 2012-07-16 Bubbles KDE Gnome 14 | Korora 18 2013-05-02 Flo KDE Gnome 15 | Korora 19 2013-07-02 Bruce KDE Gnome 16 | Korora 19.1 2013-10-08 KDE Gnome Mate Cinnamon 17 | Korora 20 2014-01-10 Peach KDE Gnome Mate Cinnamon Xfce 18 | Korora 21 2015-02-07 Darla KDE Gnome Cinnamon Xfce 19 | Korora 22 2015-08-02 Selina KDE Gnome Mate Cinnamon Xfce (see note a.) 20 | Korora 23 2016-02-07 Coral KDE Gnome Mate Cinnamon Xfce (see note b.) 21 | Korora 24 2016-07-19 Sheldon Gnome Mate Cinnamon Xfce 22 | Korora 25 2016-12-07 Gurgle KDE Gnome Mate Cinnamon Xfce 23 | Korora 26 2017-09-24 Bloat KDE Gnome Mate Cinnamon Xfce 24 | Korora 27 2017-00-00 Marlin KDE Gnome Mate Cinnamon Xfce 25 | ``` 26 | 27 | #### Notes 28 | a. named after a team member's daughter who was born during the preparation of the release 29 | 30 | b. a shared name for Nemo's mother and in remembrance of a team member's mother, who shared that name, and passed away as the release was in development 31 | -------------------------------------------------------------------------------- /DevelopingKorora/Iso-Testing.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [ISO Testing](#iso-testing) 6 | 7 | 8 | 9 | 10 | # ISO Testing 11 | 12 | Before being released all Korora ISO's should be checked that they provide the best possible experience and don't include any problems that reflect poorly on our project. A set testing routine aims to achieve a consistent standard across all Korora systems. 13 | 14 | This is based on the testing procedure used for Korora 21 ISO's. It has been added to from that experience. This should be considered the minimum requirement. Feel free to add and improve. 15 | 16 | 1. After downloading the iso's verify that the checksum matches, either with md5-, sha1- or sha256sum. 17 | 18 | 2. Once the iso's are burned to DVD or copied to a usb-stick with dd and you boot from the install media, make sure to run 'Test this media & start Korora....' first to see if it passes the test. 19 | 20 | 3. Check if they boot (preferably on both msdos and UEFI) 21 | 22 | 4. Do a sudo dnf distro-sync and make sure all our packages are in, and not some updated fedora ones that slipped in, which now want to update to Korora packages. 23 | 24 | 5. After the desktop loaded, check if 'Korora Welcome' is displayed. 25 | 26 | 6. Test to see if all the apps work. 27 | 28 | 7. Test to see if the default apps are right, e.g. touch movie.mkv and see if it opens in VLC, etc.. Check text files open in editor and not LibreOffice. 29 | 30 | 8. Test Firefox to make sure it works with the addons that are included by default. 31 | 32 | 9. Test and look if all the addons are there and working. 33 | 34 | 10. Obviously make sure the theme and stuff is right. 35 | 36 | 11. Install the OS, preferably on a real machine as well as VM. 37 | 38 | 12. Make sure languages work . Test installing in different languages. 39 | 40 | 13. Make sure users are created and that in post install everything works as expected. 41 | -------------------------------------------------------------------------------- /UsingKorora/General/Installing-Google-Chrome.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installing Google Chrome](#installing-google-chrome) 6 | - [Testing Versions](#testing-versions) 7 | 8 | 9 | 10 | 11 | # Installing Google Chrome 12 | 13 | Korora includes FireFox as its default browser but many people prefer Google Chrome. Unfortunately Chrome cannot be distributed in Korora due to its licensing restrictions. However it is simple to install Chrome in any version of Korora. **Note** there is an open source version of Chrome called **Chromium** which is in the repos, see [here](https://kororaproject.org/support/documentation/installing-chromium) for details on installing Chromium. 14 | 15 | Korora comes with many repos already set up so you can just install many software packages from the Package Manager or command line. One of the repos that is set up is Google Chrome. 16 | 17 | To install Google Chrome use the command `sudo dnf install google-chrome`. This will install the stable version of Google Chrome. 18 | 19 | 20 | ## Testing Versions 21 | As well as the stable version, Google makes available versions of Chrome for testing. These are the beta and unstable versions. These versions can be installed in Korora but first you need to edit the repo file. 22 | 23 | > Do not install these versions unless you are comfortable handling the issues that sometimes arise using test software. 24 | 25 | Using your preferred text editor open `/etc/yum.repos.d/google-chrome.repo`, you will need to prefix the command with `sudo`. The last line is an exclude statement. You will need to delete or comment out this line. Alternatively you could edit it by removing the version you wish to install from that line. 26 | 27 | The beta version will install with the command `sudo dnf install google-chrome-beta`. 28 | 29 | The unstable version will install with the command `sudo dnf install google-chrome-unstable`. 30 | -------------------------------------------------------------------------------- /UsingKorora/Updating-With-Yumex.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Updating with Yumex](#updating-with-yumex) 6 | 7 | 8 | 9 | 10 | # Updating with Yumex 11 | 12 | The Yum Extender, aka Yumex, is included with all versions of Korora because it provides a consistent interface across all desktops. Yumex is the most popular GUI for package management and is the default graphical Package Manager in Xfce and Cinnamon. 13 | 14 | > Yumex is no longer under development. See [this news item ](https://kororaproject.org/about/news/new-gui-package-manager)for more information. 15 | 16 | Using Yumex to update the system is simple as it checks for updates automatically whenever it is opened. Allow it to complete its check and display any updates. 17 | 18 | If Yumex finds some updates it will list all that are available along with some information for each package. You can click on a package and the lower panel will show a description and other details of the package. The icons on the right side of the lower panel give access to additional information including package changes. 19 | 20 | To apply the updates click “Select All” and you will see each line is selected. Next click “Apply”. Yumex will ask you for authentication, simple enter the requested password (which may be root's or your own if you are an administrator). 21 | 22 | Yumex will take over and show its progress as it gets package information and checks for dependencies. When it is ready to proceed it shows a “Transaction Result” which details everything it will do. It shows the packages to be updated, dependencies to be added and possibly unneeded packages that will be removed. To proceed click “Okay”. 23 | 24 | Yumex shows the progress of the update, a pop-up shows a summary while the main Yumex window in the background shows the details of each step. When it finishes Yumex will show its main window, which you can close now. 25 | 26 | > If the update included a new kernel or other major system package you should reboot the system. If a new version of your desktop environment has been provided you should log out and back in. 27 | -------------------------------------------------------------------------------- /UsingKorora/General/Tour-of-Korora-Software.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Tour of Korora Software](#tour-of-korora-software) 4 | - [Common Packages and Desktop Differences](#common-packages-and-desktop-differences) 5 | - [GTK-based desktops](#gtk-based-desktops) 6 | - [Qt-based desktops](#qt-based-desktops) 7 | 8 | 9 | # Tour of Korora Software 10 | 11 | One of the core aims of the Korora Project is to provide an out-of-box Linux experience that can take care of the average's users daily needs with entirely free software. To save you the trouble of digging through every preinstalled application, we have compiled a list of the prepackaged applications within each version of Korora that fulfill a specific purpose. This will hopefully save you some trouble from immediately downloading more software when the right tool may already be installed. 12 | 13 | 14 | ## Common Packages and Desktop Differences 15 | 16 | Of the five supported desktop environments for Korora, four of them are GNOME/GTK-based. As a result, they carry many packages inherited upstream from GNOME. The fifth desktop environment, KDE Plasma, has its own suite of applications and diverges heavily from the rest. The KDE applications tend to use the [Qt](https://en.wikipedia.org/wiki/Qt_(software)) framework rather than [GTK](https://en.wikipedia.org/wiki/GTK%2B). 17 | 18 | Because of KDE's significant differences, we cannot list many packages on this page that are truly common between all five DE's. However, some do exist, including those that are added by Korora. They are listed below. For the packages that are included in each specific desktop, please visit the page for that particular desktop environment. 19 | 20 | 21 | ## GTK-based desktops 22 | 23 | - [GNOME](../DesktopSpecific/GNOME-Tour-of-Software.md) 24 | - [Cinnamon](../DesktopSpecific/Cinnamon-Tour-of-Software.md) 25 | - [MATE](../DesktopSpecific/MATE-Tour-of-Software.md) 26 | - [Xfce](../DesktopSpecific/Xfce-Tour-of-Software.md) 27 | 28 | 29 | ## Qt-based desktops 30 | - [KDE Plasma](../DesktopSpecific/KDE-Tour-of-Software.md) 31 | -------------------------------------------------------------------------------- /GettingHelp/Fpaste.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [fpaste a file](#fpaste-a-file) 6 | - [fpaste the output of a command](#fpaste-the-output-of-a-command) 7 | - [fpaste with copied text](#fpaste-with-copied-text) 8 | - [Other Options](#other-options) 9 | 10 | 11 | 12 | When seeking support it is often useful to share the contents of a configuration file or the output of a command. Korora has a builtin utility for doing exactly this. It is fpaste. 13 | 14 | Fpaste makes use of the fpaste.org pastebin service. 15 | 16 | Using fpaste is simple. You run fpaste from the command line point it to the text and it gives you a url which you can share with those offering support. How you provide the text to fpaste depends on the source of that text. 17 | 18 | Note: there can be a short delay while fpaste uploads your text and receives the url. the length of that delay will depend on the speed of your internet connection and the amount of text involved. 19 | 20 | 21 | ### fpaste a file 22 | If the text is the contents of a file, e.g. a configuration file, you can simply type `fpaste filename`. E.g. to share your bash configuration file you would type `fpaste ~/.bashrc` and fpaste would return the url. 23 | 24 | 25 | ### fpaste the output of a command 26 | If you are sharing the output from a command the format is `command | fpaste`. E.g. to share the details of your graphics card type `/sbin/lspci | grep -e VGA | fpaste`. 27 | Note: it is a good idea to run the command without fpaste first so you can see the information you are sharing and to confirm the output contains the required information. 28 | 29 | 30 | ### fpaste with copied text 31 | If you wish to share some text you can simply copy it and paste it into fpaste. To do this run `fpaste` without any options, paste the test, press enter and then Ctrl + D. 32 | 33 | A short cut for this is `fpaste -io`. This will copy to selection in the primary clipboard to fpaste and return the url there. You can then paste the url in the support request. 34 | 35 | 36 | ### Other Options 37 | There are plenty of other ways to use fpaste, those above are just cover most situations. To see the other option run `man fpaste` or `fpaste -h`. 38 | -------------------------------------------------------------------------------- /UsingKorora/Keeping-Current-Package-Versions.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Keeping Current Package Versions](#keeping-current-package-versions) 6 | - [With the Command Line](#with-the-command-line) 7 | - [In Configuration Files](#in-configuration-files) 8 | - [Kernel Versions](#kernel-versions) 9 | 10 | 11 | 12 | 13 | # Keeping Current Package Versions 14 | 15 | On occasion you may find it necessary to prevent a package from updating. This usually occurs when a new version introduces a serious bug or breaks backwards compatibility with your original data. It is possible to inhibit package updates for nominated packages while still updating the rest of your system. 16 | 17 | This should not normally be a permanent setting but can be used until an update is available to fix to your bug or you've converted your data appropriately. 18 | 19 | > It is recommended that you check that a bug report has been filed for the problem. If so add a comment to the report, if not please file one. 20 | 21 | 22 | ## With the Command Line 23 | 24 | Until a fix is available you can block the offending package from updating by adding an option to the command, replace packagename with the name of the package(s), it can include characters such as `*`, 25 | 26 | ``` 27 | sudo dnf --refresh --exclude=packagename upgrade 28 | 29 | ``` 30 | 31 | 32 | ## In Configuration Files 33 | 34 | It is also possible to add the exclude option to the configuration file. If you use a gui update application this is the best option. It is a good idea to edit both the the Yum and DNF files. You will need root permission to edit this file so use `su -` or prefix the command with sudo. Add `exclude=packagename` to /etc/dnf/dnf.conf. 35 | 36 | 37 | ## Kernel Versions 38 | 39 | If the problem package is the kernel there is a another and preferred option and that is to increase the number of kernels the system retains. This will allow the latest kernel to be tested but a kernel that is known to work is retained. 40 | 41 | You will need to use `su - ` or run the editor with sudo. Increase the setting on the `installonly_limit=` line in /etc/dnf/dnf.conf. A setting of 4 or 5 is usually sufficient. 42 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Desktop-Specific.md: -------------------------------------------------------------------------------- 1 | This section contains tips and tricks that are specific to a single desktop environment. 2 | 3 | - [Cinnamon ](https://kororaproject.org/support/documentation/cinnamon) 4 | - [Autologin in Cinnamon](https://kororaproject.org/support/documentation/autologin-in-cinnamon) 5 | - [Cinnamon Shortcuts](https://kororaproject.org/support/documentation/cinnamon-shortcuts) 6 | - [Tour of Cinnamon Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-cinnamon-software-i-need-a-program-that-does-this) 7 | - [Gnome ](https://kororaproject.org/support/documentation/gnome) 8 | - [Tour of Gnome Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-gnome-software-i-need-a-program-that-does-this) 9 | - [KDE Plasma ](https://kororaproject.org/support/documentation/desktop-specific-kde) 10 | - [Autologin in KDE Plasma](https://kororaproject.org/support/documentation/autologin-in-kde-plasma) 11 | - [Tour of KDE Plasma Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-kde-plasma-software-i-need-a-program-that-does-this) 12 | - [Mate ](https://kororaproject.org/support/documentation/mate) 13 | - [Autologin in Mate](https://kororaproject.org/support/documentation/autologin-in-mate) 14 | - [Mate Shortcuts](https://kororaproject.org/support/documentation/mate-shortcuts) 15 | - [Tour of Mate Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-mate-software-i-need-a-program-that-does-this) 16 | - [Xfce ](https://kororaproject.org/support/documentation/xfce) 17 | - [Autologin in Xfce](https://kororaproject.org/support/documentation/autologin-in-xfce) 18 | - [Tour of Xfce Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-xfce-software-i-need-a-program-that-does-this) 19 | - [Updating Xfce](https://kororaproject.org/support/documentation/updating-xfce) 20 | - [Xfce Panel Switch](https://kororaproject.org/support/documentation/xfce-panel-switch) 21 | - [Xfce Shortcuts](https://kororaproject.org/support/documentation/xfce-shortcuts) 22 | - [Xfce Terminal Dropdown Option](https://kororaproject.org/support/documentation/xfce-terminal) 23 | -------------------------------------------------------------------------------- /UsingKorora/Upgrading-Known-Issues.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Upgrading - Known issues](#upgrading---known-issues) 6 | - [Package Errors](#package-errors) 7 | - [User Installed Applications](#user-installed-applications) 8 | - [Third party Repos](#third-party-repos) 9 | - [Xfce Settings](#xfce-settings) 10 | 11 | 12 | 13 | 14 | # Upgrading - Known issues 15 | 16 | Using the upgrade facility is a simple way to move to Korora 26 without the need of a full installation. Your data, settings and installed applications are still there and you can keep working on your system for much of the process. There are a few known issues that may appear during the process, although they are all easily handled and the upgrade process should then proceed as expected. 17 | 18 | There are some known upgrade issues reported on the [F26 known bugs list](https://fedoraproject.org/wiki/Common_F26_bugs#Upgrade_issues). 19 | 20 | 21 | ## Package Issues 22 | 23 | There are no reported package issues at this stage. However as Yumex-dnf is no longer developed it is recommended that Yumex-dnf be replaced with dnfdragora. 24 | 25 | ```bash 26 | sudo dnf remove yumex-dnf 27 | 28 | sudo dnf install dnfdragora 29 | ``` 30 | 31 | 32 | ## User Installed Applications 33 | 34 | Another issue that has affected a small number of people is the existence of applications installed outside of the package manager. These are usually built from source after installing the required dependencies. As those dependencies may have been updated these applications may not run or may give errors. It is advisable to re-build and or re-install these applications using the same process as employed originally. This is a good opportunity to check if they have been updated and to install the latest version. 35 | 36 | 37 | ## Third party Repos 38 | 39 | Similarly any non-standard or third party repos that have been added to the system may need to be disabled. If you see any errors connected with packages installed from those repos remove the packages and disable the repos. After the upgrade is complete the repos can be re-enabled if they have support for 26 and the packages can be installed. 40 | 41 | 42 | ## Other Issues 43 | If you experience any issues not listed here please let us know on irc or on [Engage](https://kororaproject.org/support/engage). 44 | -------------------------------------------------------------------------------- /UsingKorora/LightDM-Greeter-Settings.md: -------------------------------------------------------------------------------- 1 | The Display Manager provides the graphical login screen you see when you start your Korora system. It has options for the desktop you will run and allows you to enter your password. Korora uses LightDM as the display manager for Cinnamon, Mate and Xfce. There are a choice of greeters and you can [select the greeter](https://kororaproject.org/support/documentation/changing-the-lightdm-greeter) to use. This guide covers the GTK+ Greeter. 2 | 3 | Korora includes a graphical configuration utility for LightDM. You will find it listed as "LightDM GTK+ Greeter Settings" in System Settings or under Administration depending on the Desktop Environment you are using. It allows the setting of background, theme, user icon. location and a number of other options. It is easy and safe to change the settings in here. None of the settings will break LightDM. 4 | 5 | As the display manager is a system function you will need to provide authentication to open the configuration utility. Enter the requested password and the Greeter settings will open. Note any settings that LightDM cannot implement are shown with a asterisk beside them. 6 | 7 | ![LightDM Settings](https://github.com/kororaproject/kp-documentation/blob/master/img/LightDM-settings.png) 8 | 9 | The first screen shows the Appearance. The theme, icons, fonts, backgrounds etc are set here. These need to be installed for system wide use. 10 | >Any themes, fonts, backgrounds etc. that have been installed for a specific user only will not work in LightDM. Similarly an image in the user's home directory won't work for the background. To use your own image move it to /usr/share/backgrounds. 11 | 12 | The second screen shows the contents of the panel. The items in the panel can be moved, removed or new items added. Clicking on the "+" symbol shows the available panel items. The clock format can be set here too. The clock uses the standard clock formatting options. To review those options type `man strftime` in a terminal. 13 | 14 | The third screen shows the position of the password window. The base position can be set using the graphic at the top of the screen and fine tuned with the settings below. it may take some experimenting to get this position where you prefer it. 15 | 16 | The fourth window is for misc. settings and most people will be happy with the defaults. 17 | 18 | If you have made changes and want to reset to the previous settings before you save, click on the Reload button in the lower bar. To save your changes click the Save button. Then exit and restart Korora to check your settings. 19 | -------------------------------------------------------------------------------- /UsingKorora/Autologin-in-LightDM.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Autologin](#autologin) 6 | - [Additional Steps for Mate](#additional-steps-for-mate) 7 | 8 | 9 | 10 | LightDM is the default Display manager in Korora for Cinnamon, Mate and Xfce. When you start your Korora system it takes you to the LightDM so you can enter your password. However if you are the only user of the system you may prefer to bypass this screen and have Korora go straight to the desktop. 11 | >It is always a good idea to backup any important data before modifying system configuration. 12 | 13 | 14 | ### Autologin 15 | It is possible to set Lightdm to log in to the default user without asking for a password. 16 | >Autologin reduces the security of the system as anyone starting the system can access the default user's data without knowledge of the password. It should not be enabled without consideration of the security implications. 17 | 18 | Using your prefered text editor open /etc/lightdm/lightdm.conf. You will need root permission to edit this file so use `su -` or prefix the command with sudo. Locate the section headed `[SeatDefaults]`. Scroll down to the line starting with `#autologin-user=` and remove the `#` to uncomment the line. Add the name of the user to be logged in. The following line, `#autologin-user-timeout=0`can be edited to give access to the login screen and a delay before the system logs in. Uncomment the line and increase the setting to equal the number of seconds required. (There are some reports of Autologin not working with a timeout value greater than 0, please test with 0 before reporting a problem). 19 | 20 | #### Autologin Greeter 21 | In the repos is a package called lightdm-autologin-greeter. This is not designed for the general user. It provides a permanent autologin without access to the login screen. If a user logs out it will immediately log the default user back in. This package is designed for kiosk use. 22 | 23 | 24 | ### Additional Steps for Mate 25 | For Mate you also need to scroll down to the line starting with `#user-session=` and remove the `#` to uncomment the line and edit it to show `user-session=mate`. 26 | 27 | An alternative method is to use sed - 28 | 29 | `sudo sed -i 's/^#autologin-user=.*/autologin-user=liveuser/' /etc/lightdm/lightdm.conf` 30 | 31 | `sudo sed -i 's/^#autologin-user-timeout=.*/autologin-user-timeout=0/' /etc/lightdm/lightdm.conf` 32 | 33 | You also need to set MATE as default session, otherwise login will fail `sudo sed -i 's/^#user-session=.*/user-session=mate/' /etc/lightdm/lightdm.conf` 34 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Xfce-Terminal.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Xfce Terminal Dropdown Option](#xfce-terminal-dropdown-option) 6 | 7 | 8 | 9 | 10 | # Xfce Terminal Dropdown Option 11 | 12 | Many people prefer a dropdown terminal in place of the traditional separate application. Dropdown, sometimes called quake style, terminals allow you to have a terminal open with quick access using a hotkey and without using screen space. The current Xfce terminal has a drop down option. However it is not obvious to most people. 13 | 14 | ![](https://github.com/kororaproject/kp-documentation/wiki/img/Xfce4-Terminal.png) 15 | 16 | It is a hidden option for the standard xfce4-terminal. To access it you need to start the terminal with the command 17 | 18 | ``` 19 | xfce4-terminal --drop-down 20 | ``` 21 | 22 | The man page gives more details and suggests you bind that command to a keyboard shortcut. That way you can press the key to open the terminal and pressing it again will hide but not close the terminal. This means there is no need to add it to your sessions or Autostart. The first time the key is pressed will launch and open it. Further presses will reveal or hide it. 23 | 24 | I would suggest binding it to F12. To do this right click on the desktop, select Applications – Settings – Keyboard. Select the Application Shortcuts tab, click on the Add button, type in the command as above. Click OK and it will open another window asking for the key, press your chosen key(s) and the window will close. Test the shortcut, the terminal should open as a drop down. 25 | 26 | In Edit there is a preferences option with a new DropDown tab. Make your choices here for size, location etc. If you turn off the menu bar you can access the preferences and new tab etc. options with a right click. The Dropdown preference screen also has an option for Opacity this applies to the whole terminal including the text. The Opacity option on the Appearance tab only affects the background. The Duration option controls the speed of the animation as the terminal drops down and ascends. 27 | 28 | There is an option for a panel indicator too, it will appear in the notification area. Clicking on the panel icon will open the terminal. Right clicking gives access to the Preferences and an option to close the terminal. 29 | 30 | This is a great option for Xfce users wanting the convenience of a drop down terminal. 31 | 32 | ### Xfce Terminal Shortcuts 33 | There are a few keyboard shortcuts that can be useful, 34 | - **ctrl+shift+t** – open a new tab 35 | - **ctrl+pgup** – moves to the next tab 36 | - **ctrl+pgdn** – moves to the previous tab 37 | - **ctrl+shift+up or down** – scrolls up or down 38 | - **shift+pgup or pgdn** – scrolls up or down a page at a time 39 | -------------------------------------------------------------------------------- /GettingHelp/Getting-Help-With-Korora.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Getting help with Korora](#getting-help-with-korora) 6 | - [Engage Guidelines](#engage-guidelines) 7 | 8 | 9 | 10 | 11 | # Getting help with Korora 12 | 13 | There are a number of ways of getting help with Korora - [https://kororaproject.org/support](https://kororaproject.org/support) Korora uses a custom open source support system called Engage. We feel it's pretty self explanatory, but some details on how to use it are coming soon! 14 | 15 | If using irc please ask your question and be patient. If someone knows the answer they will reply. 16 | 17 | Engage uses a powerful syntax system which allows you to format your posts and add active links, images etc. The syntax is covered in detail at [https://kororaproject.org/support/engage/syntax](https://kororaproject.org/support/engage/syntax). 18 | 19 | Korora is based on community involvement so please help out where ever you can. If you can contribute to a discussion on Engage or irc please jump in. 20 | 21 | 22 | ## Engage Guidelines 23 | 24 | To make using Engage enjoyable and useful for everyone there are some guidelines. While they are mostly common sense and good manners please take the time to read through them, there isn't that much. 25 | 26 | We want to foster a polite, positive, intelligent and fun environment for the Korora Community. In order to achieve that, the following rules are designed to provide a measure of what's acceptable. 27 | 28 | 1. Don't be rude. Treat others with respect and always be courteous and polite, even if you disagree. Insulting, inflammatory or personal attacks will be not tolerated. 29 | 30 | 2. Use clean civil language (no swearing). Remember that some of our members are younger than others. 31 | 32 | 3. Using ALL CAPS to emphasise your point should be avoided. 33 | 34 | 4. Do not post inappropriate content, such as spam, advertising, pornographic material or anything that violates copyright. 35 | 36 | 5. Stay on topic and don't hijack a thread meant to help someone. 37 | 38 | 6. Search for any existing threads that might match your needs and only make a new thread if required. 39 | 40 | 7. The preferred language is English. We might not be able to help you if you use another language, but we may try! 41 | 42 | 8. Administrators will monitor all threads and have the right to edit or delete posts which don't meet these guidelines at their discretion. We hope not to do this, but users who violate the above rules may also be banned. 43 | 44 | 45 | **See Also** 46 | 47 | - [Fpaste](https://kororaproject.org/support/documentation/fpaste) 48 | - [Troubleshooting Tips](https://kororaproject.org/support/documentation/troubleshooting-tips) 49 | - [Using Engage](https://kororaproject.org/support/documentation/using-engage) 50 | 51 | -------------------------------------------------------------------------------- /UsingKorora/Screen-Locking-with-Light-Locker.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installation](#installation) 6 | - [Remove the Screensaver (Optional)](#remove-the-screensaver-optional) 7 | - [Xfce Specific Configuration](#xfce-specific-configuration) 8 | - [Xfce Power Manager](#xfce-power-manager) 9 | - [Xfce Xflock4 and Whisker Menu](#xfce-xflock4-and-whisker-menu) 10 | 11 | 12 | 13 | Many people dislike XScreensaver and its ugly unlock screen but keep it for the security of its screenlocking. Korora includes Xscreensaver with Xfce. Xscreensaver provides both the screensaver graphics and screenlocking for security. Screensaving isn't needed these days with modern monitors. It is a relic from the distant past of CRT monitors. You can disable the screensaving so it just blanks the screen. But you still have the ugly Xscreensaver screen to type your password. There is a better way. 14 | 15 | 16 | ### Installation 17 | First install light-locker. `sudo dnf install light-locker` is all that is needed. A restart is required. 18 | 19 | 20 | ### Remove the Screensaver (Optional) 21 | With Light Locker installed the screensaver is no longer needed so it can be removed with `sudo dnf remove xscreensaver*` 22 | 23 | When returning to a computer with the screen locked you will be presented with a screen asking for a password. If you have xscreensaver installed you will see its window. Systems without the screensaver will present the LightDM login screen. Entering the password will return you to the system as you left it. Both Xscreensaver and LightDm / Light Locker have the option to log in as a different user. 24 | 25 | 26 | ### Xfce Specific Configuration 27 | 28 | 29 | #### Xfce Power Manager 30 | When Light Locker is installed Xfce's Power Manager settings gains an additional "Security" tab which allows you to configure Light-locker. Not that much needs configuring. There are options to set how Light Locker works with the screensaver and an option to "Lock screen when system is going for sleep". This is a useful option for laptop when used in conjunction with the option to put the laptop to sleep simply by closing the lid which is found on the General tab in the Xfce Power Manager settings. 31 | Note this only affects Suspend and Hibernate. Xflock4 (see next section) will still function whatever option is set here. 32 | 33 | 34 | #### Xfce Xflock4 and Whisker Menu 35 | The Whisker menu has a Lock Screen icon. This icon is a shortcut to the Xflock4 command. Both these will stop working when Xscreensaver is removed. To use xflock4 with LightLocker run the following command as user, `xfconf-query -c xfce4-session -p /general/LockCommand -s "dm-tool lock" --create -t string`. Both the icon and the xflock4 keyboard shortcut (Ctrl + Alt + Del) will now lock the session. -------------------------------------------------------------------------------- /DevelopingKorora/Contributing-To-Documentation.md: -------------------------------------------------------------------------------- 1 | - [Suggestions](#suggestions) 2 | - [Contributions](#contributions) 3 | - [Submitting Contributions](#submitting-contributions) 4 | 5 | This section of the Korora web site is designed to provide all the information needed to obtain, install and use a Korora system. It is for you, the normal Korora user, and you can help achieve that aim by contributing suggestions and possibly documents. You don't need to be an expert to create a document, just share how you do what you do with Korora. 6 | 7 | We have a Github page where you can contribute at see [here](https://kororaproject.org/support/documentation/contribution-guidelines) for details on using the Github site. You can also contact us by email with your ideas, there are details on that page of various ways you can be involved. 8 | 9 | 10 | ## Suggestions 11 | 12 | There are many subjects that aren't yet covered but we do have a few people willing to write documentation and we want to know what you need explained. Any subject that concerns Korora is suitable to be documented. See the list of suggestions we have already received. Just contact us at **team@kororaproject.org** with your ideas. 13 | 14 | 15 | ## Contributions 16 | 17 | We are especially interested in contributions that we can share with everyone. Any subject that involves Korora may be suitable. Look through the existing documentation and choose something that isn't already covered. However it is a great idea to check with us first as someone else maybe working on the same thing. See the [list of suggestions](https://github.com/kororaproject/kp-documentation/wiki/Planned-Documentation). 18 | 19 | We are also happy to accept improvements and updates to existing documents. Just contact us with the changes needed. 20 | 21 | 22 | ### Submitting Contributions 23 | 24 | There are [guidelines](https://github.com/kororaproject/kp-documentation/wiki/Contribution-Guidelines) for contributing via Github. While that is our preferred method please feel free to use whatever method works best for you. 25 | 26 | Korora documentation uses the same syntax for formatting as Engage. However you don't need to worry about the syntax or even poor language skills as our team members are happy to edit and format the contributions before posting them. We just need you to share your knowledge. Even if you don't think you know very much, if you can do something that isn't covered we need your contribution. Others can enhance it later if needed. Just contact us at **team@kororaproject.org** with your contributions and ideas. 27 | 28 | Providing documentation is a simple and useful way you can contribute to Korora plus many people find they learn even more as they do it, so give it a go. 29 | 30 | 31 | **See Also** 32 | 33 | - [Contribution Guidelines](https://kororaproject.org/support/documentation/contribution-guidelines) 34 | - [Planned Documentation](https://kororaproject.org/support/documentation/planned-documentation) 35 | -------------------------------------------------------------------------------- /UsingKorora/General/Accessing-Text-Console.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Accessing a Text Console](#accessing-a-text-console) 6 | - [What is a Text Console?](#what-is-a-text-console) 7 | - [Accessing a Text Console](#accessing-a-text-console-1) 8 | - [Example of Using a Text Console](#example-of-using-a-text-console) 9 | 10 | 11 | 12 | 13 | # Accessing a Text Console 14 | 15 | 16 | ## What is a Text Console? 17 | 18 | Modern Linux systems use a Graphical User Interface (GUI) to interact with the user. However, there is still a non graphical or text user interface available. It provides direct access to the operating system without the desktop environment getting in the way. 19 | 20 | While it is possible to work in a text console all the time you would normally only use it when there are problems that can't be fixed in a GUI or you can't get to a GUI. 21 | 22 | 23 | ## Accessing a Text Console 24 | 25 | To enter a console hold down Control and Alt, then press F2 or F3 (there used to be more of these). It is just a method of navigating you around different desktops, F1 is the standard GUI screen and F2 & F3 are text consoles. All of them can be performing different tasks simultaneously and any user of any level can find them useful. You do not lose the GUI by switching to a console, a simple press of Ctrl + Alt + F1 will take you back. 26 | 27 | > Beware though that F7 was also commonly used for the GUI and may still be in use on some distros. 28 | 29 | 30 | 31 | 32 | >If you have a problem getting back to the GUI try using only the left Ctrl and Alt. During testing, on at least one machine, the right Ctrl and Alt keys worked in a GUI but not in a text console. 33 | 34 | 35 | ## Example of Using a Text Console 36 | 37 | As an example to see what processes are running - What you do is: `Ctrl + Alt + F2` _You should be taken to a text console_. 38 | 39 | Then type your username followed by your password, this is the same username and password you use to log in to the gui. 40 | 41 | > Please be aware that no characters will appear when you type the password but you can still backspace if you think you made an error. 42 | 43 | If greater permission is required e.g. to kill any process or install some packages you can use `sudo` or exit and log back in as `root`. This will make it less easy for an intruder to do damage. 44 | 45 | Next: `top` 46 | 47 | Top is a program (the program’s name is top in case of confusion) which will open in the console and show the currently running processes. It has excellent built in help (press h) to assist you to use it. It is very similar to Microsoft’s task manager, or one of several of the Linux GUI ones (most use top anyway). 48 | 49 | To exit top type: `Ctrl + c` 50 | 51 | To log off type: `exit` 52 | 53 | Then type: `Ctrl + Alt + F1` and you should be in a working GUI 54 | 55 | A text console works much like a terminal on your desktop which is more correctly called a virtual terminal. You can use many applications but not ones that require or depend on a GUI. For example you can use a text editor like nano but not a GUI one like Kwrite. 56 | -------------------------------------------------------------------------------- /UsingKorora/Upgrading-Korora.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Upgrading Korora](#upgrading-korora) 6 | - [Upgrading to the latest release](#upgrading-to-the-latest-release) 7 | - [Optional: Upgrade the Rescue Kernel](#optional-upgrade-the-rescue-kernel) 8 | 9 | 10 | 11 | 12 | # Upgrading Korora 13 | 14 | Korora uses Fedora's tools, so upgrading is easy! Here we'll will show you how to upgrade from one release to a new one. 15 | 16 | > This should work reliably, however you still do so at your own risk (like any upgrade). If this fails, then you will need to perform a re-install so please make sure you've backed up important data. 17 | 18 | 19 | 20 | > Contact us on [Engage](https://kororaproject.org/support/engage) if you have any problems! 21 | 22 | 23 | 24 | > There are a few [known issues](https://github.com/kororaproject/kp-documentation/wiki/Upgrading-Known-Issues) that should be reviewed before proceeding. 25 | 26 | 27 | ## Upgrading to the latest release 28 | 29 | The upgrade is performed with the help of a plugin to the system's package manager, dnf (previously there was a dedicated tool called FedUp). 30 | 31 | When run, dnf will: 32 | 33 | - Update your version 25 repositories to point to the 26 release 34 | - Download all the rpms required to upgrade your packages 35 | - Reboot your machine and install them 36 | - Boot into your upgraded system 37 | 38 | You can also review the manpage by typing the command - `man dnf.plugin.system-upgrade` 39 | 40 | First, make sure you are running the latest packages for your current version. 41 | 42 | ``` 43 | sudo dnf --refresh upgrade 44 | ``` 45 | 46 | Install the dnf system upgrade plugin, in case it's missing (it might already be installed). 47 | 48 | ``` 49 | sudo dnf install dnf-plugin-system-upgrade 50 | ``` 51 | 52 | Run the dnf system upgrade command (this will take a while to download all the updates, but you can continue using your machine in the meantime). 53 | 54 | ``` 55 | sudo dnf --refresh system-upgrade download --releasever=26 56 | ``` 57 | 58 | > If you have an issue and need to restart the system-upgrade remove the '--refresh' option from the command to use packages already downloaded. 59 | 60 | You'll be asked to accept and verify the signing keys. Enter `Y` for each key. 61 | 62 | Next, tell your system to reboot and perform the upgrade. 63 | 64 | ``` 65 | sudo dnf system-upgrade reboot 66 | ``` 67 | 68 | > There may be no display during this part of the process, however the system will install the upgrades and then reboot. 69 | 70 | Finally, your system should reboot into the freshly upgraded system. 71 | 72 | You're now ready to enjoy your upgraded system. 73 | 74 | 75 | ## Optional: Upgrade the Rescue Kernel 76 | 77 | > This should be left until the upgraded system is tested and works reliably. 78 | 79 | The rescue kernel option on the Grub boot menu isn't updated during the upgrade process. To force it to be upgraded to the new version it is necessary to rebuild the Grub configuration. To do this run 80 | 81 | ``` 82 | sudo grub2-mkconfig -o /boot/grub2/grub.cfg 83 | ``` 84 | 85 | or for EFI systems 86 | 87 | ``` 88 | sudo grub2-mkconfig -o /boot/efi/EFI/fedora/grub.cfg 89 | ``` 90 | -------------------------------------------------------------------------------- /GettingHelp/Using-Engage.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Using Engage](#using-engage) 6 | - [Asking a Question](#asking-a-question) 7 | - [Common Engage Syntax Questions](#common-engage-syntax-questions) 8 | - [Links](#links) 9 | - [Text Boxes](#text-boxes) 10 | 11 | 12 | 13 | 14 | # Using Engage 15 | 16 | [Engage](https://kororaproject.org/support/engage) is your official portal to the Korora Community. Here you can search through the available questions and thanks that other members have posted. Alternatively, submit your own and let the community help you. 17 | 18 | Using Engage is simple but here are some tips to ensure you quickly find the right answer to your question. 19 | 20 | When you open Engage there is a brief introduction that includes links to Engage Guidelines and the Syntax used. Please review these before using Engage. 21 | 22 | There are 2 options for creating a new Engage item. The first is to ask a question. The second is to Say Thanks. 23 | 24 | 25 | ## Asking a Question 26 | 27 | Before starting new item use the search facility to see if your question has already been answered. Many questions are asked more than once but why wait for someone to answer you if the issue has already been discussed. Also check the [documentation section](https://github.com/kororaproject/kp-documentation/wiki) for any guides that may answer your question. 28 | 29 | If you do start a new item include all relevant information. This includes the version of Korora and the Desktop Environment you are using. If the problem concerns a hardware issue include the model of the hardware. Also mention any changes you have made to the system such as drivers installed. If you want to add output from a command or log and it is more than 10 lines please use a paste service such as [fpaste](https://github.com/kororaproject/kp-documentation/wiki/Fpaste). Fpaste is included in Korora, see `man fpaste` for details. See below for adding links to Engage. For adding a few lines of output see Text Boxes below. 30 | 31 | Next detail the issue, specifically the steps needed to recreate it. Also mention what you have tried so far. If you used a guide from another site please provide a link to that guide. 32 | 33 | 34 | ## Common Engage Syntax Questions 35 | 36 | There is a link to the [Engage Syntax](https://kororaproject.org/support/engage/syntax) in the introduction on the Engage page. There is also a question mark above reply box that links to the information. However here are a couple of items that are used regularly. 37 | 38 | 39 | ### Links 40 | 41 | While there are a number of ways to add a link, simple links can be made by enclosing the url in greater than and less than symbols. E.g. 42 | ``` bash 43 | 44 | ``` 45 | 46 | ### Text Boxes 47 | 48 | When posting small test outputs please use text boxes. Text in text boxes will be properly formatted and easier to read. Note for large amounts of text use a paste service such as [fpaste](https://github.com/kororaproject/kp-documentation/wiki/Fpaste). To create a text box open and close it with 3 x backticks, E.g. 49 | 50 | ```` 51 | ``` 52 | paste your text here 53 | ``` 54 | ```` 55 | -------------------------------------------------------------------------------- /UsingKorora/General/Pulse-Audio.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [PulseAudio Volume Control (pavucontrol)](#pulseaudio-volume-control-pavucontrol) 6 | - [Configuration Tab](#configuration-tab) 7 | - [Output Devices](#output-devices) 8 | - [Input Devices](#input-devices) 9 | - [Recording and Playback Tabs](#recording-and-playback-tabs) 10 | 11 | 12 | 13 | 14 | # PulseAudio Volume Control (pavucontrol) 15 | 16 | This application is the most important tool for controlling the audio performance of your system. It sets the devices used, the output and input settings, per application settings as well as the volume. 17 | 18 | Pavucontrol has several tabs to separate the various functions and it is worth taking a few minutes to explore the settings on each tab. In order from left to right they are Playback, Recording, Output Devices, Input Devices and Configuration. 19 | 20 | >Hint. You may need to click on the left and right arrows to see all the tabs. 21 | 22 | 23 | ## Configuration Tab 24 | The Configuration Tab shows the various audio devices on the system. Most systems will show built in Digital and analogue option here. If you have other devices such as an external USB Audio card that will also appear. The defaults will be the best option in most cases. 25 | 26 | 27 | ## Output Devices 28 | The Output Devices is probably the most used tab as it shows the available outputs and the volume settings for those devices. The built-in analogue stereo output is usually used for the built-in speakers and headphone socket. Most systems will automatically switch to headphones when there are plugged in. Hint. Older external speakers used the headphone socket and so may appear as headphones when connected. 29 | 30 | There is a slider to set the volume for each output. On the right side of the device title are 3 buttons. The first is the mute control. When selected the volume slider will be greyed out. 31 | 32 | The second button locks the channels together. Unless you need to adjust the channel output separately this button isn’t needed and should be left in the default selected condition. The third button allows you to select one output as the fallback. If you select a particular device as the output for one application and it isn’t available this is the device that will play the sound. This is much like selecting a default output. 33 | 34 | 35 | ## Input Devices 36 | The Input devices tab works exactly lie the Output Devices but controls recording devices such as microphones and line in. 37 | 38 | 39 | ## Recording and Playback Tabs 40 | We can look at these together as they function in the same way. Any application that is playing or recording audio will appear in the appropriate tab. An application will only appear while it is actually functioning. That is an application will not appear until it is outputting or recording audio. Just having an application open will not cause it to appear. The name of the application is shown and to the right of that is shown the device it is using. By clicking on the device you can select an alternative device. Below that is a volume level. Using that it is possible to have different applications output audio at different volume levels. There is one difference between the Playback and Recording tabs. On the playback tabs there is a permanent listing for system sounds. You can’t select the output device but you can set the volume or mute the System sounds. 41 | -------------------------------------------------------------------------------- /DevelopingKorora/Planned-Documentation.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Planned Documentation](#planned-documentation) 6 | - [Getting Korora](#getting-korora) 7 | - [Using Korora](#using-korora) 8 | - [Canvas (when it comes along)](#canvas) 9 | - [Developing for Korora](#developing-for-korora) 10 | 11 | 12 | 13 | 14 | # Planned Documentation 15 | 16 | The following are suggested topics to be added to the documentation section. These are only suggestions and shouldn't be considered a limiting factor for submissions. Any topic connected with using Korora may be suitable for inclusion. 17 | 18 | Any submissions are gratefully accepted, see [here ](https://github.com/kororaproject/kp-documentation/wiki/Contributing-To-Korora)for information on how to contribute. 19 | 20 | _A username after the topic indicates they are currently working on that topic_. Please create a Pull request for any alterations or email **team@kororaproject.org** . 21 | 22 | 23 | ### Getting Korora 24 | 25 | - Creating Bootable Media - needs updating 26 | - Installing Korora - needs updating and completing 27 | - Version Timetable 28 | - Supported Versions 29 | 30 | 31 | ### Using Korora 32 | 33 | - Desktop specific 34 | 35 | - How to use the desktop 36 | 37 | - Cinnamon 38 | 39 | - Desktop Layout and Philosophy 40 | - Opening / Searching for applications 41 | - Managing your files 42 | - Workspaces 43 | - etc. 44 | 45 | - GNOME 46 | - Desktop Layout and Philosophy 47 | - Opening / Searching for applications 48 | - Managing your files 49 | - Workspaces 50 | - etc. 51 | 52 | - KDE Plasma 53 | - Desktop Layout and Philosophy 54 | - Opening / Searching for applications 55 | - Managing your files 56 | - Workspaces 57 | - etc. 58 | 59 | - MATE 60 | - Desktop Layout and Philosophy 61 | - Opening / Searching for applications 62 | - Managing your files 63 | - Workspaces 64 | - etc. 65 | 66 | - Xfce 67 | - Desktop Layout and Philosophy 68 | - Opening / Searching for applications 69 | - Managing your files 70 | - Workspaces 71 | - etc. 72 | 73 | - Applications 74 | - Gimp 75 | - Libreoffice 76 | - Firefox 77 | - etc. 78 | 79 | - Adding and Removing Software 80 | - Introduction to repositories 81 | - Managing repositories, if need be (e.g., Spotify) 82 | - Managing software with repositories 83 | - Managing software without repositories? 84 | 85 | - Updating the system 86 | - Updating on GNOME 87 | - Updating on KDE Plasma 88 | - Updating with Dnfdragora - _cWs_ 89 | - DNF History and Downgrade 90 | 91 | - Command line 92 | 93 | - General 94 | - Hardware 95 | - Setting up a printer - *ozjd* 96 | - Configuring A Wifi connection 97 | - Configuring the Firewall 98 | - Man Pages 99 | - Networking 100 | - Simple Home Network 101 | - Hibernation 102 | - Virtualisation - _AdmiralAsshat_ 103 | - Boxes 104 | - VirtManager - _AdmiralAsshat_ 105 | - VirtualBox (update existing draft) 106 | 107 | 108 | ### Canvas (when it comes along) 109 | 110 | 111 | ### Developing for Korora 112 | 113 | - Git Intro 114 | - Software stack 115 | - Pseudo SDK 116 | - Building Korora 117 | - Background on how the build is done (kickstarts, etc) 118 | -------------------------------------------------------------------------------- /UsingKorora/changing-the-lightdm-greeter.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Installation](#installation) 4 | - [Configuration](#config) 5 | - [Settings](#settings) 6 | 7 | LightDM is a display manager which handle the initialisation and login to several Korora desktop environments. While LightDM processes the login it doesn't include the graphical login screen which is known as the greeter. There is a choice of greeter screens in the repos and there may be others available elsewhere. 8 | 9 | Mate and Xfce use the GTK+ greeter as did Cinnamon until version 26. Cinnamon now uses the Slick greeter. However they are interchangeable and you can replace the included one with an alternative. 10 | 11 | The GTK+ Greeter as used in Mate and Xfce 12 | 13 | ![LightDM_Greeter_GTK](https://github.com/kororaproject/kp-documentation/blob/master/img/Lightdm-Greeter-GTK.png?raw=true) 14 | 15 | The Slick greeter as used in Cinnamon. 16 | 17 | ![LightDM_Greeter_Slick](https://github.com/kororaproject/kp-documentation/blob/master/img/Lightdm-Greeter-Slick.png?raw=true) 18 | 19 | 20 | ### Installation 21 | To see the available greeters type `dnf list *greet*` and you will see something like 22 | ``` 23 | Installed Packages 24 | lightdm-gtk-greeter-settings.noarch 25 | slick-greeter.x86_64 26 | 27 | Available Packages 28 | kgreeter-plugins.x86_64 29 | lightdm-autologin-greeter.noarch 30 | pantheon-greeter.x86_64 31 | ``` 32 | The actual packages shown may differ on other versions. Ignore the Kgreeter, it isn't part of LightDM. The autologin greeter is a special greeter for kiosk setups and not for general use. 33 | 34 | To install another greeter, e.g. the Slick Greeter, type `dnf install slick-greeter`. This command needs to be run as root using `su -` or prefixed with sudo. 35 | 36 | 37 | ### Configuration 38 | To see the available greeters in your system, type `ls -l /usr/share/xgreeters`, it will show something like 39 | ``` 40 | -rw-r--r--. 1 root root 187 Aug 22 17:13 lightdm-gtk-greeter.desktop 41 | -rw-r--r--. 1 root root 131 Jul 7 09:48 slick-greeter.desktop 42 | ``` 43 | The important information is the name of the .desktop files. So the GTK+ greeter is called 'lightdm-gtk-greeter' and the Slick greeter is 'slick-greeter'. 44 | 45 | To activate the desired greeter edit /etc/lightdm/lightdm.conf. To do this, we need to edit the file as root (substitute _nano -w_ for your favourite editor, such as _kwrite_ for KDE). 46 | 47 | ```bash 48 | sudo nano -w /etc/lightdm/lightdm.conf 49 | ``` 50 | Change the greeter-session line in 'seat', replacing the name there with the name of the desired greeter and uncommenting the line. E.g. when set up for the Slick greeter, the first few lines of the Seat section will look like 51 | ``` 52 | [Seat:*] 53 | #type=xlocal 54 | #pam-service=lightdm 55 | #pam-autologin-service=lightdm-autologin 56 | #pam-greeter-service=lightdm-greeter 57 | #xserver-command=X 58 | #xmir-command=Xmir 59 | #xserver-config= 60 | #xserver-layout= 61 | #xserver-allow-tcp=false 62 | #xserver-share=true 63 | #xserver-hostname= 64 | #xserver-display-number= 65 | #xdmcp-manager= 66 | #xdmcp-port=177 67 | #xdmcp-key= 68 | #unity-compositor-command=unity-system-compositor 69 | #unity-compositor-timeout=60 70 | greeter-session=slick-greeter 71 | ``` 72 | 73 | 74 | ### Settings 75 | Both the Slick Greeter and the GTK+ Greeter provide a Settings options application. The Slick Greeter app is called "Login Window" while the GTK+ Greeter is called "[LightDM GTK+ Greeter Settings](https://kororaproject.org/support/documentation/lightdm-greeter-settings)". They will be found in the Adminstration settings section of the menu or Settings Manager. 76 | -------------------------------------------------------------------------------- /GettingKorora/Getting-Korora.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Getting Korora](#getting-korora) 6 | 7 | 8 | 9 | 10 | # Getting Korora 11 | 12 | You've taken a look at the site and you might be wondering to yourself, "How can I take a look at this great Linux distribution?" 13 | 14 | Well, wonder no more. 15 | 16 | From what you've seen on the website, Korora has a special blend of aesthetics and functionality, and you've already seen that Korora aims to make Linux easy for new users while still being powerful enough for use by experts. 17 | 18 | Now you'd like to give it a try. 19 | 20 | Visit the [Download Page](https://kororaproject.org/download) to choose a version to download (below you will find a brief overview of each of the desktop environments available to Korora users). 21 | 22 | The minimum installation requirements for Korora are: 23 | * 64 bit Intel-compatible CPU 24 | * 2GB memory (RAM) 25 | * 20GB disk space 26 | 27 | Follow the instructions on the Download Page to [create a Live USB stick](https://kororaproject.org/support/documentation/creating-bootable-media). We encourage you to first try Korora using a Live USB stick to get a better idea on how the distro will perform on your hardware. 28 | 29 | (Note: Making a live USB stick is the preferred method of trying and/or installing Korora. You can also burn a Korora DVD, however our experience has found that running a live DVD in many cases does not give you a true reflection of Korora's performance. For installing purposes, however, a live DVD will work just fine). 30 | 31 | Korora gives you the option of five desktop environments, which are: 32 | 33 | **CINNAMON:** Cinnamon is built atop core GNOME technologies like GTK and provides a more traditional desktop while including some advanced features. Cinnamon is very flexible and configurable. For more information on Korora Cinnamon, visit our [Cinnamon page](https://kororaproject.org/discover/cinnamon). 34 | 35 | **GNOME:** Sweeping away the clutter, GNOME's new desktop takes elegance to a new level. GNOME is a simple and easy-to-use desktop which is the most beautiful version ever, including a new visual theme, a refined new font, and carefully crafted animations. For more information on Korora GNOME, visit our [Gnome page](https://kororaproject.org/discover/gnome). 36 | 37 | **KDE:** KDE's Plasma Desktop offers a beautiful desktop that takes complete advantage of modern computing technology. Using visual effects and scalable graphics, the desktop experience is not only smooth but also pleasing to the eye. For more information on Korora KDE, visit our [KDE page](https://kororaproject.org/discover/kde) 38 | 39 | **MATE:** MATE, a fork of GNOME 2, continues the long tradition of providing an intuitive and attractive desktop environment while adding a much needed overhaul in both back and front-end functionality. For more information on Korora MATE, visit our [Mate page](https://kororaproject.org/discover/mate). 40 | 41 | **Xfce:** A lightweight desktop with speed and function, Xfce maintains a visually appealing desktop while aiming to be fast while using a lower amount of system resources. Xfce offers both speed and functionality as its core strength. For more information on Korora Xfce, visit our [Xfce page](https://kororaproject.org/discover/xfce). 42 | 43 | For help choosing the desktop that is right for you see [here](https://github.com/kororaproject/kp-documentation/wiki/Which-Desktop-For-Your-Korora) 44 | 45 | 46 | - [Which Desktop for Your Korora](https://kororaproject.org/support/documentation/which-desktop-for-your-korora) 47 | - [Creating Bootable Media](https://kororaproject.org/support/documentation/creating-bootable-media) 48 | - [Installing Korora](https://kororaproject.org/support/documentation/installing-korora) 49 | - [Installing Korora - Video Guide](https://kororaproject.org/support/documentation/korora-install-how-to) 50 | -------------------------------------------------------------------------------- /DevelopingKorora/Contribution-Guidelines.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [How To Contribute](#how-to-contribute) 4 | - [File Hierarchy](#file-hierarchy) 5 | - [GettingKorora](#gettingkorora) 6 | - [UsingKorora](#usingkorora) 7 | - [GettingHelp](#gettinghelp) 8 | - [File Naming Conventions](#file-naming-conventions) 9 | - [Image Naming Conventions](#image-naming-conventions) 10 | - [Tables of Contents](#toc) 11 | 12 | **This section provides Guidelines for those that wish to contribute to the Korora Documentation.** 13 | 14 |

We welcome all contributions to the Korora Documentation and our preferred method is through our GitHub repo. When using that method please follow these guidelines. Anyone with any questions or unable to contribute in this format please contact us at team@kororaproject.org.

15 | 16 | 17 | ## How To Contribute 18 | 19 | If you wish to contribute to the Korora Docs via GitHub, first you must create a GitHub account if you have not already done so. 20 | 21 | You must then fork the repo ( you will find the button at the top of the page). 22 | 23 | ![Guidelines](https://github.com/kororaproject/kp-documentation/blob/master/img/Contibution-Guidelines-Fork.png?raw=true) 24 | 25 | You must then submit a pull request for any new documentation you may add, which will then be subject to review before inclusion. Korora documentation uses the [same syntax for formatting](https://kororaproject.org/support/engage/syntax) as Engage. For both new documents and improvements / updates to existing documents please create one pull request for each document. 26 | 27 | 28 | 29 | ## File Hierarchy 30 | 31 | 32 | 33 | ### GettingKorora 34 | This folder includes installation, creating bootable media, choosing a desktop Etc. 35 | 36 | 37 | ### UsingKorora 38 | This folder includes general use, desktop specific guides, upgrading / updating, GRUB, Bootloader Etc 39 | 40 | 41 | ### GettingHelp 42 | This folder includes how to get support, using Engage Etc 43 | 44 | 45 | ## File Naming Conventions 46 | When adding new files, please follow the following file naming guidelines: 47 | 1. File name must relate to the topic 48 | 2. Must be in English and start with a capital letter 49 | 3. All files must be in markdown format (`.md`) 50 | 4. If using multiple words in the file name, use CamelCase and separate each word with a hyphen (eg: `Using-Korora.md`) 51 | 52 | 53 | 54 | ## Image Naming Conventions 55 | All images are to be placed in the `img `folder. 56 | 57 | When naming your images please name them using the name of your file and if multiple images, further name them with a number or heading for which they are under, for example: `Contribution-Guidelines-Fork.png`. 58 | 59 | For images that are hosted in the repo to appear in documents on the Korora website they require the full path with `?raw=true` appended e.g. 60 | ``` 61 | ![Contribution-Guidelines-Fork](https://github.com/kororaproject/kp-documentation/blob/master/img/Contribution-Guidelines-Fork.png?raw=true) 62 | ``` 63 | 64 | 65 | ## Tables of Contents 66 | When there are 2 or more sub headings within a document, a Table of Contents should be included. They are simple to create using the sample below which includes the code for the table for this document and the first heading. 67 | ``` 68 | **Table of Contents** 69 | 70 | - [How To Contribute](#how-to-contribute) 71 | - [File Hierarchy](#file-hierarchy) 72 | - [GettingKorora](#gettingkorora) 73 | - [UsingKorora](#usingkorora) 74 | - [GettingHelp](#gettinghelp) 75 | - [File Naming Conventions](#file-naming-conventions) 76 | - [Image Naming Conventions](#image-naming-conventions) 77 | - [Tables of Contents](#toc) 78 | 79 | 80 | ## How To Contribute 81 | ``` 82 | 83 | Anyone with any questions or unable to contribute in this format please contact us at **team@kororaproject.org**. 84 | -------------------------------------------------------------------------------- /UsingKorora/Slick-Greeter-Settings.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Appearance](#appearance) 4 | - [Users](#users) 5 | - [Settings](#settings) 6 | 7 | The Display Manager provides the graphical login screen you see when you start your Korora system. It has options for the desktop you will run and allows you to enter your password. Korora uses LightDM as the display manager for Cinnamon, Mate and Xfce. There are a choice of greeters and you can [select the greeter](https://kororaproject.org/support/documentation/changing-the-lightdm-greeter) to use. This guide covers the Slick Greeter settings. 8 | 9 | Korora includes a graphical configuration utility for LightDM Slick Greeter. You will find it listed as "Login Window" in System Settings or under Administration depending on the Desktop Environment you are using. It provides for the setting of a number of options. It is easy and safe to change the settings in here. None of the settings will break LightDM. 10 | 11 | As the display manager is a system function you will need to provide authentication to open the configuration utility. Enter the requested password and the Login Window settings will open. The settings are divided into 3 sections with Tabs to select the three sections at the top of the window. The sections cover appearane settings, options for user access and general settings. 12 | 13 | ![LightDM Slick Settings1](https://github.com/kororaproject/kp-documentation/blob/master/img/Slick-Greeter-settings1.png?raw=true) 14 | 15 | 16 | #### Appearance 17 | 18 | The first option is the background. You can select to display an image or a plain coloured screen. There is a further option to create a dotted grid effect over the login screen. The purpose for this is unknown 19 | 20 | The theme and icons are set next. Then there are options for other pictures. If you have multiple monitors the secondary monitors can display a different image to the main monitor. 21 | 22 | You can also display an image or logo in the bottom left hand corner. 23 | 24 |

Any themes, fonts, backgrounds etc. that have been installed for a specific user only will not work in LightDM. Install any themes and icons for all users. 25 | 26 | Similarly an image in the user's home directory won't work for the background. To use your own image move it to /usr/share/backgrounds.

27 | 28 | 29 | #### Users 30 | 31 | ![LightDM Slick Settings2](https://github.com/kororaproject/kp-documentation/blob/master/img/Slick-Greeter-settings2.png?raw=true) 32 | 33 | These are options that control the user access. Most are self explanatory. The user list can be hidden so only the default (or most recent) user will be displayed. The next option will allow guest logins. It should normally be left off. 34 | 35 | The last section allows an automatic login for a particular user. 36 |

Autologin reduces the security of the system as anyone starting the system can access the selected user's data without knowledge of the password. It should not be enabled without consideration of the security implications.

37 | 38 | 39 | #### Settings 40 | 41 | ![LightDM Slick Settings3](https://github.com/kororaproject/kp-documentation/blob/master/img/Slick-Greeter-settings3.png?raw=true) 42 | 43 | The final section is for general settings. It includes a section on the additional information that will be displayed on the LightDM screen. 44 | 45 | The first option will activate the numlock on keyboard with separate numeric keypads. 46 | 47 | The next option is for HiDPI screens. If you have a HiDPI monitor that isn't properly recognised you may need to explicitly set it here however most users will be happy with the default Auto setting. 48 | 49 | The next section covers the items that appear in LightDM's top panel. Most people will be happy with the defaults but feel free to experiment. E.g. if you are on a desktop you may wish to turn the Battery power indicator off. 50 | 51 | Some settings are marked to indicate a reboot is required for your changes to be activated but for any other changes Log Out and back in to check your settings. 52 | -------------------------------------------------------------------------------- /DevelopingKorora/building-isos-with-canvas.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Why Build](#why) 4 | - [Up to Date ISOs](#up-to-date) 5 | - [Testing Pre-Release Versions](#test) 6 | - [Community Versions](#community) 7 | - [Prepare Your System](#prepare) 8 | - [Build Command](#build) 9 | - [Support and Bug Reports on Canvas](#support) 10 | - [Feedback on Pre-Release Systems](#feedback) 11 | 12 | 13 | ## Building ISOs with Canvas 14 | Canvas is the application Korora team members use to build Korora ISOs and it is included in each Korora system. Building ISOs is only one of its functions but that is what is covered here. There are more details on Canvas on our [Github site](https://github.com/kororaproject/kp-canvas/tree/master/upstream/client). 15 | 16 | ### Why build 17 | You may ask why would you build your own ISOs when Korora does that for you? There are a number of reasons but here are 3. 18 | 19 | #### Up to Date ISOs 20 | After Korora is released there are a constant series of package updates. While it is a good idea to update the system immediately after installation and keep it up to date, there is a better option. If you are installing a new Korora system you can use Canvas to build your own updated ISO which will then include all the latest packages. 21 | 22 | #### Testing Pre-Release Versions 23 | Before Korora is released the team build and test pre-release versions of the various ISOs. However for recent versions we haven't released beta versions for general testing. Now you can build a pre-release version and provide feedback before the final version is released. While pre-release versions are not recommended for day to day use, the feedback provided will ensure the final released version is the best it can be. 24 | 25 |

Pre-release versions may contain untested applications and may be based on beta releases. As such they are for testing purposes only and not recommended for day to day use.

26 | 27 | #### Community Versions 28 | One of the features of Canvas is that anyone can create a special version of Korora. It is anticipated that many people will share their creations. These may be desktop environments that Korora doesn't provide or special use systems such as gaming systems, media servers etc. There will be a library of community versions that you can choose from. 29 | 30 |

The Korora team have not tested or approved community versions which may contain untested applications and may be based on beta releases. As such only limited support may be available for them.

31 | 32 | ### Prepare Your System 33 | First check you have the latest version of Canvas installed, `sudo dnf --refresh upgrade canvas`. There is only one extra package needed, livecd-tools. `sudo dnf install livecd-tools`. 34 | 35 | ### Build Command 36 | Systems are based on templates that Korora has prepared. To list the available templates type `canvas template list`. This will show all the templates that you can use. The list will include any templates you have created and all public templates. 37 | 38 | The command to create an ISO is 39 | ``` 40 | sudo canvas template iso name_of_chosen_template --releasever nn --livecd-creator 41 | ``` 42 | So e.g. the command to build Korora Xfce version 26 will be `sudo canvas template iso kororaproject:korora-live-xfce --releasever 26 --livecd-creator` 43 | 44 | This process will take some time as it will download all the required packages and then assemble the ISO. You can follow the progress as it continues. 45 | 46 | When the process is complete you will find the ISO in /var/tmp/canvas/template_of_your_choice/iso/. This ISO can be used just like any ISO downloaded from the Korora site. 47 | 48 | ### Support and Bug Reports on Canvas 49 | If you have any questions on Canvas and building systems please feel free to ask on our irc channel or on [Engage](https://kororaproject.org/support/engage). 50 | 51 | Bug reports can filed [here](https://github.com/kororaproject/kp-canvas/tree/master/upstream/client). Suggestions and Pull Requests are always welcome. 52 | 53 | ### Feedback on Pre-Release Systems 54 | Feedback such as suggestions, issues and ideas on the pre-release ISOs is appreciated and best provided on [Engage](https://kororaproject.org/support/engage). 55 | -------------------------------------------------------------------------------- /UsingKorora/General/Installing-Oracle-Java.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installing Oracle's Java](#installing-oracles-java) 6 | - [Download Java](#download-java) 7 | - [Slotting Java](#slotting-java) 8 | - [Test Java](#test-java) 9 | - [Updating Java](#updating-java) 10 | 11 | 12 | 13 | 14 | # Installing Oracle's Java 15 | 16 | One of the things that Oracle did after it pried Java from Sun's cold dead hands was to change the license so that no Linux distributions could distribute it any more. 17 | 18 | By default, Korora comes with the OpenJDK version of Java and you probably don't want to uninstall it because some applications depend on it. You can see the OpenJDK version when you query Java. 19 | 20 | ``` 21 | java -version 22 | ``` 23 | In order to install Oracle's Java it must be done manually, but fortunately it's not too difficult thanks to the way Java can be slotted (multiple versions installed) on Linux. 24 | 25 | 26 | ## Download Java 27 | 28 | Head over to the [Java download page](http://www.oracle.com/technetwork/java/javase/downloads/index.html) and select either the JRE (runtime environment) or the JDK (development kit) of the SE (standard edition). 29 | 30 | ![](https://github.com/kororaproject/kp-documentation/blob/master/img/install-oracle-java-download.jpg) 31 | 32 | At the download page, agree to the license and then download the RPM for your architecture (64 bit JDK in the example below) and save it somewhere like your Downloads directory. 33 | 34 | ![](https://github.com/kororaproject/kp-documentation/blob/master/img/install-oracle-java-select.jpg) 35 | 36 | In our example, the file we downloaded is called _jdk-7u51-linux-x64.rpm _ however yours will most certainly be different so substitute as appropriate. 37 | Install Java 38 | 39 | You can install this RPM using a graphical package manager if you like, however we also need to use the command line to configure the slotting so let's do it all there instead. 40 | 41 | Open up a terminal program, such as Konsole in KDE, and install the RPM which should end with Complete! message. 42 | 43 | ``` 44 | sudo yum install ~/Downloads/jdk-7u51-linux-x64.rpm 45 | ``` 46 | 47 | Now that we have Oracle's Java installed you can see where this was installed to by running the following command. 48 | 49 | ``` 50 | rpm -ql jdk 51 | ``` 52 | 53 | Or if you're installing the jre, this. 54 | 55 | ``` 56 | rpm -ql jre 57 | ``` 58 | 59 | You will note that Java was installed to_ /usr/java/_ however the RPM also creates a symbolic link so that _/usr/java/latest _ always points to the version you have installed. That's great because we can use that when configuring our slotting and if you upgrade the RPM in the future you will automatically be running the latest version! 60 | 61 | 62 | ## Slotting Java 63 | 64 | To add that new Java to the list of slotted versions we use the alternatives command. This looks complicated, but it's installing another option for the_ /usr/bin/java_ executable (called java) which is at _/usr/java/latest/bin/java_ (where the RPM installed Java to). The number on the end sets the priority over any other java binaries (the highest number wins) when using alternatives in an automatic state (we will use manual). 65 | 66 | ``` 67 | sudo /usr/sbin/alternatives --install /usr/bin/java java /usr/java/latest/bin/java 999999 68 | ``` 69 | 70 | Now, we can select this version of Java to use as our default! Simpy run this command and select the number that corresponds with the _/usr/java/latest/bin/java_ entry. 71 | 72 | ``` 73 | sudo /usr/sbin/alternatives --config java 74 | ``` 75 | 76 | If you installed the JDK you can also do the same for _javac_, the Java compiler. 77 | 78 | ``` 79 | sudo /usr/sbin/alternatives --install /usr/bin/javac javac /usr/java/latest/bin/javac 999999 80 | sudo /usr/sbin/alternatives --config javac 81 | ``` 82 | 83 | 84 | ## Test Java 85 | 86 | Test that you're running the right version with the same version command we ran at the beginning when only OpenJDK was installed. 87 | 88 | 89 | 90 | 91 | Note that you shouldn't see OpenJDK any more, but something like Java(TM) SE Runtime Environment along with the version you installed! 92 | 93 | 94 | ## Updating Java 95 | 96 | Unfortunately this is also a manual process, however now that you've already configured the slotting to use the latest symlink you can simply download and install the latest Java RPM as above. 97 | 98 | Enjoy! 99 | -------------------------------------------------------------------------------- /Development-Notes.md: -------------------------------------------------------------------------------- 1 | 2 | **Table of Contents** 3 | 4 | - [Recent Changes](#recent-changes) 5 | - [Suggestions](#suggestions) 6 | - [Categorise Docs](#categorise-docs) 7 | - [Installation Etc.](#installation-etc) 8 | - [Using and Tip](#using-and-tip) 9 | - [Support and Development](#support-and-development) 10 | - [Creation of Contributers Documentation](#creation-of-contributers-documentation) 11 | - [Sync to Site](#sync-to-site) 12 | - [Known Incompatibilites](#known-incompatibilites) 13 | 14 | 15 | 16 | These are notes on the development of this section and will be removed when the wiki is operational. **Anyone with suggestions feel free to add or comment.** 17 | 18 | This project started as a result of the discussion on https://github.com/kororaproject/website/issues/55 and also the request from a number of people to allow contributions by pull requests. 19 | 20 | It has been agreed that the wiki won't be used and so it will no longer be updated. The repo will be maintained and it will be used to develop new documents and to accept contributions from the community. The repo will contiue to host the images used on the Korora website documentation. 21 | 22 | 23 | ## Recent Changes 24 | Footer - added, copied from the website 25 | Sidebar - added, however not really required unless it is intended that the wiki be used as the documentation site. Needs manual addition of new pages. 26 | 27 | 28 | ## Suggestions 29 | The lack of sync between the repo and the wiki is going to be a major ongoing issue. Keeping them matching is a difficult job when it needs to be done manually. 30 | 31 | Need to standardise layout. Some docs have a leading H1 which (usually) duplicates the doc title and therefore is superfluous on the wiki. Suggest a H2 is used when it differs from the title and otherwise removed. 32 | There is also inconsistent use of H2 and H3 within docs. This should be standardised as well. 33 | 34 | ~~It was suggested that we create a separate repo for documentation, - "if you really want to be able to use PRs for documentation you can use a normal github repo to do the PRs on and the repo owners (those with push permissions) can manually sync to the wiki repo when new documentation is added/accepted" 35 | If this is done it may be better to move this wiki to that repo. 36 | This would also solve the image storage issue as covered in https://github.com/kororaproject/website/issues/56~~ Done 37 | 38 | ~~It may be necessary to create a Contribution Guidelines doc to simplify acceptance of contributions. One possible issue is image names which could be duplicated. Suggest names reflect the document they attach to.~~ Done. 39 | 40 | 41 | ## Categorise Docs 42 | ~~add folders to categorise~~ Done 43 | 44 | ### Installation Etc. 45 | covers getting, installing, upgrading and updating 46 | 47 | ### Using and Tip 48 | cover using, Tip and Tricks, could get very large, 49 | 50 | ### Support and Development 51 | covers getting help and developing 52 | 53 | 54 | ## Creation of Contributors Documentation 55 | ~~The creation of guidelines for those that wish to contribute to the docs to be created. This will cover:~~ Done 56 | 57 | 1. How To Contribute 58 | 2. File Hierarchy 59 | 3. File Naming Conventions 60 | 4. Image Naming Conventions 61 | 62 | 63 | ## Sync to Site 64 | 2 documents have been added that cover the most common needs to sync to the website. 65 | First is a totally new document (albeit with formatting that is not supported on the site) - https://github.com/kororaproject/website/wiki/Working-With-Archives 66 | Second is an existing document that has been edited - https://github.com/kororaproject/website/wiki/Which-Desktop-for-Your-Korora 67 | 68 | An alternative to syncing back to the website would be to use the wiki and change the link on the website. This change would require the approval of the core team. 69 | After some trial and error it was found that for images to appear on kp.org they need to use the full path with ?raw=true appended. 70 | 71 | ### Known Incompatibilities 72 | The Korora website accepts HTML in documentation but it is ignored on GitHub. 73 | The Korora site doesn't handle tables which work on GitHub. Simple tables may be created using code blocks which use monospace fonts but these may need to be formated manually. 74 | The Korora site doesn't create section links which are needed for TOC so these need to be added manually 75 | 76 | -------------------------------------------------------------------------------- /UsingKorora/General/Qt-Theming.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [QT Theming on GTK Desktops](#qt-theming-on-gtk-desktops) 6 | - [qt5ct](#qt5ct) 7 | - [Installation Fix for qt5ct in Xfce](#qt5ct_installation) 8 | - [Qt-config](#qt-config) 9 | 10 | 11 | 12 | 13 | # QT Theming on GTK Desktops 14 | 15 | There are 2 common toolkits used to create applications and desktops in Linux systems. These are GTK and Qt. All desktops in Korora apart from KDE Plasma are built on GTK, Plasma is built on Qt. However most applications are built on one or the other. There are a few applications such as Dnfdragora which come with GUI interfaces for both toolkits but most only use one. It is fine to use QT applications on GTK desktops however they may not honour the look and feel of GTK themes. 16 | 17 | The toolkit used will affect how an application looks on your desktop. Few desktop themes support both GTK and Qt. If you are running an application built on Qt on a GTK desktop there are a couple of configuration options that will help make them look at home among your GTK applications. Which one you use will depend on the version of Qt used to build the application. You may be able to work which your application uses by checking the dependencies installed with it or by checking the About information in its help section. 18 | 19 | The latest version is 5 and qt5ct is used to configure Qt5 applications. Those built for the older Qt4 need qt-config. Fortunately both are in the repos. 20 | 21 | >Some QT applications include appearance settings in their Preferences. These may be used as well to mimic the appearance of your GTK theme. Try setting the general configuration with the Qt config utilities and then fine tune within the application. 22 | 23 | 24 | ## qt5ct 25 | 26 | qt5ct can be installed with `sudo dnf install qt5ct`. Once installed qt5ct will appear in your menu as "Qt5 Settings". The actual location will depend on your desktop but check under Settings or similar. There have been some issues reported installing qt5ct on Xfce and possibly other desktops. If qt5ct doesn't run after installation see [below](#qt5ct_installation) for the fix. 27 | 28 | When launched there are several tabs but the main tab is the first one, "Appearance". The style option shows a number of choices. Try the gtk option first. It will attempt to copy the GTK style theming and make the appearance of the Qt application resemble your selected GTK theme. 29 | 30 | If that isn't what you want try the others. If none are suitable you can create a colour palette so it at least matches the GTK colours. For most people this can be left as default as the colours will be set along with the theme The lower half of the screen shows how the application will look. 31 | 32 | The other tabs are less important but you may choose to set the font. The icon theme should be set the same as in GTK. (The default icon theme for Korora in Numix Circle). 33 | 34 | Under Interface there are several options. You can even select to have some visual effects. The other options are personal preference and many people will be happy with the defaults. 35 | 36 | The final tab is for a custom style sheet. Usually this will be left blank. 37 | 38 | 39 | ### Installation Fix for qt5ct on Xfce 40 | An additional package is required, `sudo dnf install qt5-qtstyleplugins`. Then copy Xfce's Initrc file and edit it - `cp /etc/xdg/xfce4/xinitrc ~/.config/xfce4/xinitrc`. Edit it with your preferred test editor e.g. `nano .config/xfce4/xinitrc` add this at the top: 41 | 42 | ``` 43 | QT_QPA_PLATFORMTHEME=qt5ct 44 | export QT_QPA_PLATFORMTHEME 45 | ``` 46 | Now, log out, and log back into Xfce and qt5ct will run. 47 | 48 | 49 | ## Qt-config 50 | 51 | qt-config can be installed with `sudo dnf install qt-config`. Once installed it will appear in the menu as "Qt4 Config". The actual location will depend on your desktop but check under Settings or similar. 52 | 53 | Qt-config has one advantage over qt5ct. It includes some helpful information in the left hand pane. 54 | 55 | Operation is similar to qt5ct but the screens are a little different. Again under "Appearance" select the gui style as GTK. It will try to copy the GTK style theming and make the appearance of the Qt application resemble your selected GTK theme. The lower half of the screen shows how the application will look. 56 | 57 | The other tabs cover fonts and the interface which has settings for effects and feel. In all the tabs read through the useful information in the side panel before changing any settings. 58 | -------------------------------------------------------------------------------- /UsingKorora/How-to-Install-and-Run-Virtualbox.md: -------------------------------------------------------------------------------- 1 | ## Background 2 | So your computer system is made up of three (main) components: 3 | Physical hardware (computer bits) 4 | Kernel (software which talks to your hardware and makes it work, think drivers) 5 | Software (talks to your kernel to get to your hardware) 6 | Your kernel is what makes your computer work (this is actually what Linux is, a kernel) and it’s actually the most important part of the operating system. When you’re talking about VirtualBox, it needs to create fake hardware on top of your real hardware, so to that, it needs a driver. Drivers sit in the kernel layer. 7 | 8 | The Linux kernel has thousands of drivers in it, but it does not have VirtualBox drivers in it (yet). This means you need to compile these and load them into your running kernel of you want to use VirtualBox. Once you do that, your kernel will have the fake hardware that the VirtualBox software needs to run. Drivers which you can load and unload into the kernel are called modules. 9 | 10 | The VirtualBox host computer needs these drivers, but the VirtualBox guest also needs some drivers to make full use of the hardware. When you install Linux or Windows as a VirtualBox guest, the hardware is fake, so that OS needs drivers too! Some of those drivers (like audio and network) are already in the Linux kernel, so if your guest is running Linux, you just need drivers for the video, etc. 11 | ## Requirements 12 | In order to compile the drivers for VirtualBox (on both host and guest) on Linux you need some development libraries, compiler program (such as GCC), as well as the headers for the running kernel. You need the headers because you need to compile a driver to load into the kernel and it needs to know detailed information about it. 13 | 14 | Fortunately, if you’re using Korora, all of the required tools and packages are already installed! :smile: All you need to do is build the drivers. 15 | 16 | If you’re running a vanilla instance of Fedora, then you need to install the build tools like so: 17 | `su -c 'dnf install gcc kernel-devel'` 18 | Now you have the build tools required to compile the drivers. 19 | 20 | ## Automatically building drivers after kernel update 21 | Modules are for a specific kernel and so when you get a kernel update, you need to re-compile the drivers for VirtualBox hosts and guests. Fortunately, there’s a neat little package called DKMS (Dynamic Kernel Module Support Framework) which will do this for you automatically – and of course Korora comes with this pre-installed. 22 | 23 | If you’re running Fedora, you can easily install it like so: 24 | `su -c 'dnf install dkms time'` 25 | When you install VirtualBox (see below), it will register the drivers with DKMS and on boot it will re-compile them for you, if it needs to. So, you just need to do it once and forget! Any updates to VirtualBox that are pulled in will also be automatically updated. 26 | 27 | ## Building drivers on the host 28 | Because Korora has all of the requirements for VirtualBox (including the package repository), all you need to do to get VirtualBox up and running is to install it using the package manager. If you prefer, you can install it manually like so (note the version is currently 4.1): 29 | `sudo yum install VirtualBox-4.3.6` 30 | 31 | Again, if you’re using vanilla Fedora, then you need to grab the RPMFusion repository file so that you can install VirtualBox from the Oracle repository (the packaged version from Fedora is usually a few versions behind). 32 | `su -c 'wget http://download.virtualbox.org/virtualbox/rpm/fedora/virtualbox.repo -O /etc/yum.repos.d/virtualbox.repo'` 33 | Now you can install VirtualBox as above. 34 | 35 | ## Group permissions 36 | Just remember that any user who wants to run and use VirtualBox on the host needs to be in the vboxusers group. You can use the users graphical tool to do this (system-config-users), or add them to the group by running the command (substitute chris with your username): 37 | `sudo gpasswd -a chris vboxusers` 38 | Then just run VirtualBox and away you go! 39 | 40 | ## Building drivers on the guest 41 | Once you have your host up and your guest operating system installed, the way to install the required drivers is using the built in method. Once you have booted your guest operating system, simply click the Devices menu at the top, and click Install Guest Addons. 42 | 43 | 44 | This will load a CD in your guest and you can run the autorun.sh script from the disk, which will ask you for the root password and then detect your operating system and compile the drivers for you. 45 | 46 | 47 | Once again, if your guest is running Korora too, then you already have the required build tools and libraries. If not, you will need to install them first – how this is done depends on your distro (for Fedora, see above). 48 | 49 | That’s it! Just reboot your guest and away you go. 50 | -------------------------------------------------------------------------------- /UsingKorora/dnfdragora.md: -------------------------------------------------------------------------------- 1 | Dnfdragora and Updater 2 | 3 | **Table of Contents** 4 | 5 | - [Dnfdragora](#dnfdragora) 6 | - [File Menu](#file) 7 | - [Options](#options) 8 | - [Software Management](#manage) 9 | - [Updating](#updating) 10 | - [Optional: Dnfdragora Updater](#updater) 11 | 12 | ![Dnfdragora](https://github.com/kororaproject/kp-documentation/blob/master/img/DNG-Dragora-1.png?raw=true) 13 | 14 | 15 | While there are some dedicated terminal line users who use the dnf package manager, today’s end user likes the graphical option for installing software. Gnome and KDE have dedicated software centers that fulfill this purpose. However the other DEs’ do not have have this feature. Dnfdragora provides a graphical frontend to the command line tool dnf and is cross platform compatible. Simply look into the administrative section of your DE's menu to find this program. 16 | 17 | 18 | ### Dnfdragora 19 | Dnfdragora is divided into 2 programs, the updater and the program itself. The program is fairly user friendly and self-intuitive. Simply review the various embedded menus into understand how dnfdragora fully works. Let’s begin with reviewing the upper left embedded menus. The upper right corner has the Help menu. At this time the manual is not embedded. 20 | 21 | 22 | #### File Menu 23 | ![File](https://github.com/kororaproject/kp-documentation/blob/master/img/DNF-Dragora-3.png?raw=true) 24 | 25 | File, which is on the upper left side, contains the following options: Reset the selection, Refresh Metadata, Repositories 26 | The enabled software repositories populate on the screen. The end user can enable various repositories here. The additional repositories are only enabled for the current session. 27 | 28 | Choosing the Quit option will close dnfdragora. 29 | 30 | 31 | #### Options 32 | ![Options](https://github.com/kororaproject/kp-documentation/blob/master/img/DNF-Dragora-4.png?raw=true) 33 | 34 | Options will populate the software behavior for the program. By default when dnfdragora starts it will query the repositories and check for needed updates. Additionally you can have dnfdragora continue to scan for updates when needed while the OS is operating. 35 | 36 | 37 | #### Software Management 38 | ![Software Management](https://github.com/kororaproject/kp-documentation/blob/master/img/DNF-Dragora-5.png?raw=true) 39 | 40 | Under the Software Management header is the main areas of use. There are three menu options here: Groups, To update, and in names. These three menus are relational. With the correct sub menu choices it is possible to find the desired software. For example I want to install Leafpad. I would choose the Groups, All, and in names menu options. I would then enter text into search word bar looking for Leafpad and I would choose the Search button. The program will cache the the groups to find the program. (I suggest waiting for the caching groups from packages to be finalized before choosing the Search button.) 41 | 42 | Click the blank square next to the Name to activate a gray arrow. This gray arrow selects the program installation. Finally press the Apply button to install Leafpad. 43 | 44 | A new window populates the screen describing the transaction dependency. 45 | 46 | ![Transaction](https://github.com/kororaproject/kp-documentation/blob/master/img/DNF-Dragora-6.png?raw=true) 47 | 48 | Simply click the OK button at the bottom, the Authenticate Box will then ask for the root password to enable the install. Simply that is a basic introduction to using dnfdragora. 49 | 50 | ![aunthenticate](https://github.com/kororaproject/kp-documentation/blob/master/img/DNF-Dragora-7.png?raw=true) 51 | 52 | 53 | #### Updating 54 | When dnfdragora is started it will check for any available updates and if it finds any the new packages will be displayed in the Software Management area. Simply click on Check All and then Apply. Dnfdragora will then proceed as detailed above and will install the updates. 55 | 56 | 57 | ### Optional: dnfdragora-updater 58 | The updater is not included in Korora at this time due to some outstanding issues. One concerns resuming for Suspend and Hibernate, (see [here](https://github.com/manatools/dnfdragora/issues/45)). The other is issues when the default icon theme isn't used, see [here](https://github.com/manatools/dnfdragora/issues/55). Until these issues are solved we can't recommend it. 59 | 60 | To install Dnfdragora-updater use the command `sudo dnf install dnfdragora-gui` or search for it in dnfdragora. 61 | 62 | The dnfdragora-updater was developed after dnfdragora was created based off user requests. On my desktop the updater is a simple box that has four drop down options: Update, Open dnfdialog, Check for updates, and Exit. You can think of these options as shortcut icons. 63 | 64 | The Check for Updates will search for new software upgrades. Update will install the available upgrades. Open dnfdragora dialog opens the dnfdragora graphical utility. Exit will simply close the program. 65 | 66 | The updater will periodically check for new updates. You then need to open dnfdragora to install the updates. 67 | -------------------------------------------------------------------------------- /UsingKorora/General/Installing-Other-Desktops.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installing Other Desktops](#installing-other-desktops) 6 | - [Why would you install other DEs?](#why-would-you-install-other-des) 7 | - [Installation](#installation) 8 | - [Method 1.](#method-1) 9 | - [Method 2.](#method-2) 10 | - [Removing the New Desktop](#removing-the-new-desktop) 11 | 12 | 13 | 14 | 15 | # Installing Other Desktops 16 | 17 | Korora comes with a choice of a number of desktop environments (DEs) however as Korora is based on Fedora there is a large range of alternate environments and window managers you can add to Korora. These include Openbox, LXDE, Sugar and E17 from the Fedora repos and E18 Enlightenment and LXQT are available from external repos. You can also add another of desktops Korora offers. 18 | 19 | 20 | ## Why would you install other DEs? 21 | 22 | Each has its own features and advantages e.g. Enlightenment and the various *Box variants are known to be very light and so work well on older, slower hardware (or blazingly fast on new hardware :) ) or you may want to try the latest DE like LXQT. Sugar is designed as a learning environment for children. You can have as many DE’s as you want or have disk space for. 23 | 24 | 25 | ## Installation 26 | 27 | Before following either of these methods it is best to do a full update sudo dnf --refresh upgrade. If you get any major updates including a new kernel, reboot. 28 | 29 | > It is always a good idea to backup any important data before modifying system configuration. 30 | 31 | 32 | ## Method 1. 33 | 34 | You can install any DE with the command `sudo dnf install @de-desktop` where de is the desktop name, e.g. `sudo dnf install @lxde-desktop` will install Lxde. However this will bring in the entire desktop including many applications which will duplicate applications you already have installed e.g. each desktop environment has its own file manager. A better way is to use Yumex as in the second method. 35 | 36 | When it completes log out or reboot. At the login screen you will have the option to select the new environment. The environment you last logged into will be the default for future logins until you manually select a different one. 37 | 38 | 39 | ## Method 2. 40 | 41 | Yumex is the graphical front end for the command line yum command. It is included with Korora and in the menu. Yumex lets you easily select and unselect packages, showing you basic information on each package to help you choose and it will then install the selected packages. 42 | 43 | > Yumex is no longer under development. See this news item for more information. 44 | 45 | As an example we will install Xfce in Korora. 46 | 47 | Start Yumex. It will check for updates but shouldn’t find any if you just did an update. Select the Check box for Groups, on the left panel click the arrow for Xfce. 48 | 49 | This reveals a number of groups for the Xfce desktop, select the Xfce group. Looking at the right panel it shows as checked the packages that will be installed. Any already installed are shown in green. Optional packages are listed but not checked and in black. Look through the list and uncheck any package you don’t want. You will probably want everything in the base Xfce group. Repeat for the other groups such as applications, multimedia. You may not want to install everything from these groups, e.g. as Korora comes with the most popular multimedia applications you probably won't select anything in the Multimedia group. Clicking on the package will show basic information about it below. Repeat for the other Xfce groups. 50 | 51 | Click apply and Yumex will process the dependencies and show what it is going to do. Click OK when you are ready and the packages will be installed. 52 | 53 | If you install a desktop such as Xfce that is available in Korora you should install the Korora settings for that desktop too. There may be other Korora additions for a desktop too. To install the Korora packages type sudo `dnf install korora*desktopname` replace desktopname with the desktop you are installing, e.g. the command for Xfce is `sudo dnf install korora*xfce. 54 | ` 55 | When it completes log out or reboot. At the login screen you will have the option to select the new environment. The environment you last logged into will be the default for future logins until you manually select a different one. 56 | 57 | Explore and try something new. 58 | 59 | 60 | ## Removing the New Desktop 61 | 62 | The new desktop can be left in the system even if you don't use it. Using the reverse commands to those above, i.e. replacing the install with remove, will remove packages needed by your system and so should never be done. 63 | 64 | If you wish to remove the new desktop and you haven't made any other changes to the packages on your system you can use the `dnf history undo` option to remove the newly installed packages. If you have made changes the undo option may still work but the more changes that have been made will reduce the chances of success. If dnf can not undo the procedure it will refuse to do so to protect your system. 65 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Mate-Shortcuts.md: -------------------------------------------------------------------------------- 1 | # Mate Shortcuts 2 | **Table of Contents** 3 | 4 | - [Changing the Defaults Shortcut Keybindings](#keybindings) 5 | - [Emergency Shortcuts](#emergency) 6 | - [Launch a Console Terminal](#console) 7 | - [Restart Mate](#restart) 8 | - [Shut Down](#shutdown) 9 | - [Session Shortcuts](#session) 10 | - [Lock Screen](#lock) 11 | - [Workspace Shortcuts](#workspace) 12 | - [Switch to Left Workspace](#leftwork) 13 | - [Switch to Right Workspace](#rightwork) 14 | - [Send Current Window to Left Workspace](#sendleft) 15 | - [Send Current Window to Right Workspace](#sendright) 16 | - [Open the Menu and Search bar](#menu) 17 | - [Window Mangement](#wm) 18 | - [Cycle between Open Windows / Applcation](#cycle) 19 | - [Cycle between Open Windows of the Same Application](#cyclesame) 20 | - [Screenshots](#screen) 21 | - [Take a Screenshot](#screenf) 22 | - [Take a Screenshot of the Current Window](#screenw) 23 | 24 | 25 | 26 | The Mate desktop environment has a number of built-in shortcuts for manipulating the system's resolution, switching workspaces, and launching applications. Mastery of these shortcuts will greatly reduce the amount of time spent clicking around menus and potentially boost your productivity. 27 | 28 | **NOTE**: We will not cover all of the available shortcuts. You can look at the Keyboard menu discussed below in order to see them all. This article will cover some of the ones you are most likely to use. 29 | 30 | **NOTE on Key Terminology**: 31 | 32 | * If your keyboard came from a Mac, the `Alt` key might be labeled `Option` instead. 33 | * If your keyboard came from a Mac, you likely have a `Command` key. If you have a Windows-based keyboard, you likely have a Windows key. These keys are referred to in the Linux world as the `Super` key (or `Meta` key in emacs and a few other contexts) 34 | * The \` key is sometimes called the `grave` or `backtick`. It is usually found above the Tab key, and shares its key with the tilde (~). 35 | 36 | ## Changing the Default Shortcut Keybindings 37 | 38 | We will be discussing the shortcuts as they exist on a freshly-installed instance of Korora Mate. However, if you would like to change the default shortcuts to better suit your keyboard or workflow, you are free to do so by opening the Keyboard settings application, which can be reached by navigating through the following menu path: 39 | 40 | **Menu -> System -> Preferences -> Hardware -> Keyboard Shortcuts** 41 | 42 | ![keyboard-shortcuts](https://github.com/kororaproject/kp-documentation/wiki/img/mate-shortcuts.png?raw=true "Keyboard Shortcuts window") 43 | 44 | ## Emergency Shortcuts 45 | 46 | ### Launch a Console Terminal 47 | 48 | If Mate becomes unresponsive or you need to otherwise access a text-only console terminal outside of the window manager, enter the following command: 49 | 50 | Ctrl + Alt + F2 51 | 52 | You can switch back to the GUI by hitting: 53 | 54 | Ctrl + Alt + F1 55 | 56 | ### Restart Mate 57 | 58 | If Mate has become buggy or unusable, you can try restarting it via the following: 59 | 60 | Ctrl + Alt + Escape 61 | 62 | ### Shut Down 63 | 64 | Ctrl + Alt + Del 65 | 66 | ## Session Shortcuts 67 | 68 | ### Lock Screen 69 | 70 | Ctrl + Alt + L 71 | 72 | ## Workspace Shortcuts 73 | 74 | **NOTE**: You can have as many workspaces as you like. When the documentation refers to moving "left" or "right", it means referring to the workspace immediately to the left or right of your current workspace. For example, if you are currently on Workspace 3, moving to the left workspace would switch you to Workspace 2. Moving to the right would shift you to Workspace 4, etc. 75 | 76 | ### Switch to left workspace 77 | 78 | Ctrl + Alt + Left Arrow 79 | 80 | ### Switch to right workspace 81 | 82 | Ctrl + Alt + Right Arrow 83 | 84 | ### Send current window to left workspace 85 | 86 | Ctrl + Alt + Shift + Left 87 | 88 | ### Send current window to right workspace 89 | 90 | Ctrl + Alt + Shift + Right 91 | 92 | ## Launch the Menu Application and Search Bar 93 | 94 | Super 95 | 96 | ## Window Management 97 | 98 | ### Cycle between open windows / applications 99 | 100 | To cycle from left to right, use: 101 | 102 | Alt + Tab 103 | 104 | To cycle in the reverse direction, use: 105 | 106 | Alt + Shift + Tab 107 | 108 | ### Cycle between open instances of the same application 109 | 110 | By default `Alt + Tab` to cycle open windows will lump all instances of an application together. If you wish to cycle through those clumps of the same application (e.g. multiple File windows, multiple instances of Firefox, etc.), use the following command: 111 | 112 | Alt + Grave (`) 113 | 114 | ## Screenshots 115 | 116 | ### Take a Screenshot 117 | 118 | Print / PrtScr 119 | 120 | ### Take Screenshot of the Current Window 121 | 122 | Alt + PrtScr 123 | -------------------------------------------------------------------------------- /UsingKorora/Using-Korora.md: -------------------------------------------------------------------------------- 1 | Details on how to use your Korora system. 2 | 3 | **Document List** 4 | 5 | - [Bootloader](https://kororaproject.org/support/documentation/bootloader) 6 | - [Grub 2 Configuration Customisation](https://kororaproject.org/support/documentation/grub-2-configuration-customisation) 7 | - [LightDM](https://kororaproject.org/support/documentation/lightdm) 8 | - [Autologin in LightDM](https://kororaproject.org/support/documentation/autologin-in-lightdm) 9 | - [Automatically Unlock The Keyring when Logging In](https://kororaproject.org/support/documentation/automatically-unlock-the-keyring-when-logging-in) 10 | - [Changing the LightDM Greeter](https://kororaproject.org/support/documentation/changing-the-lightdm-greeter) 11 | - [LightDM GTK+ Greeter Settings](https://kororaproject.org/support/documentation/lightdm-greeter-settings) 12 | - [Screen Locking with Light Locker](https://kororaproject.org/support/documentation/screen-locking-with-light-locker) 13 | - [Slick Greeter Settings](https://kororaproject.org/support/documentation/slick-greeter-settings) 14 | - [Desktop Specific](https://kororaproject.org/support/documentation/desktop-specific) 15 | - [Cinnamon ](https://kororaproject.org/support/documentation/cinnamon) 16 | - [Autologin in Cinnamon](https://kororaproject.org/support/documentation/autologin-in-cinnamon) 17 | - [Cinnamon Shortcuts](https://kororaproject.org/support/documentation/cinnamon-shortcuts) 18 | - [Tour of Cinnamon Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-cinnamon-software-i-need-a-program-that-does-this) 19 | - [Gnome ](https://kororaproject.org/support/documentation/gnome) 20 | - [Tour of Gnome Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-gnome-software-i-need-a-program-that-does-this) 21 | - [KDE Plasma ](https://kororaproject.org/support/documentation/desktop-specific-kde) 22 | - [Autologin in KDE Plasma](https://kororaproject.org/support/documentation/autologin-in-kde-plasma) 23 | - [Tour of KDE Plasma Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-kde-plasma-software-i-need-a-program-that-does-this) 24 | - [Mate ](https://kororaproject.org/support/documentation/mate) 25 | - [Autologin in Mate](https://kororaproject.org/support/documentation/autologin-in-mate) 26 | - [Mate Shortcuts](https://kororaproject.org/support/documentation/mate-shortcuts) 27 | - [Tour of Mate Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-mate-software-i-need-a-program-that-does-this) 28 | - [Xfce ](https://kororaproject.org/support/documentation/xfce) 29 | - [Autologin in Xfce](https://kororaproject.org/support/documentation/autologin-in-xfce) 30 | - [Tour of Xfce Software ("I need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-xfce-software-i-need-a-program-that-does-this) 31 | - [Updating Xfce](https://kororaproject.org/support/documentation/updating-xfce) 32 | - [Xfce Panel Switch](https://kororaproject.org/support/documentation/xfce-panel-switch) 33 | - [Xfce Shortcuts](https://kororaproject.org/support/documentation/xfce-shortcuts) 34 | - [Xfce Terminal Dropdown Option](https://kororaproject.org/support/documentation/xfce-terminal) 35 | - [General](https://kororaproject.org/support/documentation/general) 36 | - [Accessing a Text Console](https://kororaproject.org/support/documentation/accessing-a-text-console) 37 | - [How to Backup Your System](https://kororaproject.org/support/documentation/how-to-backup-your-system) 38 | - [Back in Time](https://kororaproject.org/support/documentation/back-in-time) 39 | - [Déjà Dup](https://kororaproject.org/support/documentation/deja-dup) 40 | - [Installing Google Chrome](https://kororaproject.org/support/documentation/installing-google-chrome) 41 | - [Installing Oracle's Java](https://kororaproject.org/support/documentation/installing-oracles-java) 42 | - [Installing Other Desktops](https://kororaproject.org/support/documentation/installing-other-desktops) 43 | - [Installing Skype](https://kororaproject.org/support/documentation/installing-skype) 44 | - [PulseAudio Volume Control (pavucontrol)](https://kororaproject.org/support/documentation/pulseaudio-volume-control-pavucontrol) 45 | - [QT Theming on GTK Desktops](https://kororaproject.org/support/documentation/qt-theming) 46 | - [Solving Audio Issues](https://kororaproject.org/support/documentation/solving-audio-issues) 47 | - [Sudo](https://kororaproject.org/support/documentation/sudo) 48 | - [Tour of Korora Software ("I Need a Program That Does This")](https://kororaproject.org/support/documentation/tour-of-korora-software-i-need-a-program-that-does-this) 49 | - [Working with Archives](https://kororaproject.org/support/documentation/working-with-archives) 50 | - [Updating Korora](https://kororaproject.org/support/documentation/updating-korora) 51 | - [Keeping Current Package Versions](https://kororaproject.org/support/documentation/keeping-current-package-versions) 52 | - [Updating via Command Line](https://kororaproject.org/support/documentation/updating-via-command-line) 53 | - [Updating with Yumex](https://kororaproject.org/support/documentation/updating-with-yumex) 54 | - [Upgrading Korora](https://kororaproject.org/support/documentation/upgrading-korora) 55 | -------------------------------------------------------------------------------- /GettingKorora/Which-Desktop-for-Your-Korora.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | **Table of Contents** 5 | 6 | - [Applications](#applications) 7 | - [Xfce](#xfce) 8 | - [MATE](#mate) 9 | - [Cinnamon](#cinnamon) 10 | - [KDE Plasma](#kde-plasma) 11 | - [GNOME](#gnome) 12 | - [Summary](#summary) 13 | 14 | 15 | 16 | 17 | So you finally decided that Korora is the distro for you. However, you are now faced with a daunting task of which flavor or desktop environment (DE) to use. Korora currently offers the following: 18 | - XFCE 19 | - MATE 20 | - Cinnamon 21 | - KDE Plasma 22 | - GNOME 23 | 24 | Exactly what is the DE? It is a complete graphical interface for the end user that ties the various software systems together. Most proprietary operating systems only implement a single supported desktop environment. However, Linux is about choice, so the end user can choose which DE to implement! 25 | There are advantages and disadvantages to each DE. Two questions can simplify the process: 26 | - What type of desktop experience does the user want? 27 | - What type of hardware will be running Korora? 28 | 29 | The suggestions below are only that--suggestions. Have fun and explore the DE world with Korora under that digital skin. 30 | 31 | The basic minimum hardware requirements for Korora are: 32 | - 64-bit Intel Compatible CPU 33 | - 2GB RAM 34 | - 20GB of disk space 35 | 36 | Any of the DE's can run on these hardware requirements, however some of the DE's may not meet the end-user expectations due to poor performance. 37 | 38 | 39 | 40 | ### Applications ### 41 | While some DEs may include several native apps that are developed specifically for those environments, all versions of Korora come with a full range of applications. See [here](https://kororaproject.org/discover) for more details. 42 | 43 | Now let's review each of these DEs’ in further detail. 44 | 45 | 46 | 47 | ### Xfce ### 48 | Xfce aims for a lightweight environment that is low on RAM usage. Xfce first was created in 1996 by Olivier Fourdan. It allows older hardware to operate well on Korora. It is a very stable DE that can be customized using plugins to interact with user settings. Xfce runs well with 2GB RAM and even better with more. With some effort, it can be configured to mimic a traditional DE. However, it has fewer native apps when compared to the other four environments. 49 | 50 | 51 | ### MATE ### 52 | MATE is another lightweight environment like Xfce. MATE was born out of a dissatisfaction with the direction GNOME 3 had taken over the conventional desktop metaphor employed by GNOME 2. As such, the developers of MATE chose to fork GNOME 2 and continue development of its applications while keeping the familiar look of the earlier version. Despite being based on an earlier version of GNOME, MATE is one of the newest DEs, having first debuted in 2011. Xfce is marginally faster, but MATE is light on RAM consumption, too. It has elements of various GNOME apps, but has more native apps than Xfce. MATE aims to be a complete and modern desktop. It works well with 2GB RAM or higher. 53 | 54 | 55 | ### Cinnamon ### 56 | Cinnamon, too, began with GNOME 3 dissatisfaction. Instead of explicitly continuing with GNOME 2, however, the Mint developers decided to make alterations to GNOME 3 itself in order to bring back some of the desktop's familiarity. Cinnamon has a nice array of native apps. It was developed in 2011 for the Linux Mint distribution. Today this DE is popular and is spread across numerous Linux Distros. It matches the mainstream operating systems in terms of menu layout and graphical interface. Therefore this desktop is commonly recommended for a new Linux user, due to using a common visual layout similar to Windows. However, the graphical intensive approach is best used with 4 GB RAM or higher. 57 | 58 | 59 | ### KDE Plasma ### 60 | Matthias Ettrich started KDE in 1996. It is now known as KDE Plasma. This DE is very widespread across the BSD and Linux communities. It is very well-maintained and supported. This DE has a vast array of apps used in the software centre. Like Cinnamon, it mirrors the traditional layout, however it is a refined product and is heavily customizable. A new Linux user can quickly learn KDE Plasma, however there are many advanced features to satisfy those looking for something special. This DE is best used with 4GB RAM or higher on your hardware. 61 | 62 | 63 | ### GNOME ### 64 | GNOME is the current flagship DE for Fedora. GNOME is built on top of a shell and works with extensions, somewhat similar to the internet browser extensions. It started on March 3rd, 1999. This DE is streamlined and places an emphasis on accessibility for all individuals. If the modern interface is undesired, the GNOME Shell can be disabled, and the Classic GNOME DE can be activated. Like KDE Plasma, it has a robust software centre and easy-to-understand layout. The GNOME shell requires 4GB RAM or higher on your hardware. 65 | 66 | 67 | ### Summary ### 68 | Which desktop you choose is a matter of personal preference. All of the Korora desktops are available as live systems that can be demoed without installation on your computer. So you can test drive them all and see which one you prefer. You don't need to limit yourself to just one, either. It is possible to install others along side your first choice, see [this guide](https://github.com/kororaproject/kp-documentation/wiki/Installing-Other-Desktops). 69 | 70 | 71 | We hope this guide was useful in determining the appropriate desktop environment for your Korora computer! 72 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Xfce-Shortcuts.md: -------------------------------------------------------------------------------- 1 | # Xfce Shortcuts 2 | **Table of Contents** 3 | 4 | - [Changing the Defaults Shortcut Keybindings](#keybindings) 5 | - [Emergency Shortcuts](#emergency) 6 | - [Launch a Console Terminal](#console) 7 | - [Session Shortcuts](#session) 8 | - [Lock Screen](#lock) 9 | - [Log Out of the Current Session](#logout) 10 | - [Open the Whisker Menu and Search bar](#whisker) 11 | - [Screenshots](#screen) 12 | - [Take a Screenshot](#screenf) 13 | - [Take a Screenshot of the Current Window](#screenw) 14 | - [Window Management](#wm) 15 | - [Cycle between Open Windows / Applications](#cycle) 16 | - [Show Desktop](#show) 17 | - [Workspace Shortcuts](#workspace) 18 | - [Switch to Left Workspace](#leftwork) 19 | - [Switch to Right Workspace](#rightwork) 20 | - [Send Current Window to Previous Workspace](#prevwork) 21 | - [Send Current Window to Next Workspace](#nextwork) 22 | 23 | The Xfce desktop environment has a number of built-in shortcuts for manipulating the system, switching workspaces and launching applications. Mastery of these shortcuts will greatly reduce the amount of time spent clicking around menus and potentially boost your productivity. 24 | 25 | **NOTE**: We will not cover all of the available shortcuts. You can look at the Keyboard menu discussed below in order to see them all. This article will cover some of the ones you are most likely to use. 26 | 27 | **NOTE on Key Terminology**: 28 | 29 | * If your keyboard came from a Mac, the `Alt` key might be labeled `Option` instead. 30 | * If your keyboard came from a Mac, you likely have a `Command` key. If you have a Windows-based keyboard, you likely have a Windows key. These keys are referred to in the Linux world as the `Super` key (or `Meta` key in emacs and a few other contexts) 31 | * The \` key is sometimes called the `grave` or `backtick`. It is usually found above the Tab key, and shares its key with the tilde (~). 32 | 33 | **NOTE on Super Key in Xfce**: 34 | One of the special features of Korora Xfce is the inclusion of Ksuperkey. This allows the Super key to be used as a shortcut by itself as well as to be used as part of a combination shortcut. 35 | 36 | ## Changing the Default Shortcut Keybindings 37 | 38 | We will be discussing the shortcuts as they exist on a freshly-installed instance of Korora Xfce. However, if you would like to change the default shortcuts to better suit your keyboard or workflow, you are free to do so by opening the Keyboard settings application, which can be reached by navigating through the following menu paths: 39 | **Menu -> Settings -> Keyboard -> Application Shortcuts** for Application and Session Shortcuts 40 | 41 | ![keyboard-shortcuts](https://github.com/kororaproject/kp-documentation/blob/master/img/Xfce-Shortcuts-apps.png "apps Shortcuts window") 42 | 43 | or 44 | 45 | **Menu -> Settings -> Window Manager -> Keyboard** for Window Mangement and Workspace shortcuts 46 | 47 | ![keyboard-shortcuts](https://github.com/kororaproject/kp-documentation/blob/master/img/Xfce-Shortcuts-wm.png "WM Shortcuts window") 48 | 49 | ## Emergency Shortcuts 50 | 51 | ### Launch a Console Terminal 52 | 53 | If Xfce becomes unresponsive or you need to otherwise access a text-only console terminal outside of the window manager, enter the following command: 54 | 55 | Ctrl + Alt + F2 56 | 57 | You can switch back to the GUI by hitting: 58 | 59 | Ctrl + Alt + F1 60 | 61 | ## Session Shortcuts 62 | 63 | ### Lock Screen 64 | 65 | Ctrl + Alt + Del 66 | 67 | ### Log Out of Current Session 68 | 69 | Ctrl + Alt + L 70 | 71 | ## Open the Whisker Menu and Search Bar 72 | 73 | Super 74 | **Note:** the keyboard shortcut menu shows this shortcut as Alt + F1. This is part of the setup of Ksuperkey which makes the Super key more useful. 75 | 76 | ## Screenshots 77 | 78 | ### Take a Screenshot 79 | 80 | Print / PrtScr 81 | 82 | ### Take a Screenshot of the Current Window 83 | 84 | Alt + PrtScr 85 | 86 | ## Window Management 87 | 88 | ### Cycle between open windows / applications 89 | 90 | To cycle from left to right, use: 91 | 92 | Alt + Tab 93 | 94 | To cycle in the reverse direction, use: 95 | 96 | Alt + Shift + Tab 97 | 98 | **NOTE**: Xfce 4.12 added an option to have a preview of the Window instead of an icon when using ALT-Tab to cycle windows. The option uses the compositor so will only work when Compositing is on. This option can be turned off in Settings – Window Manager Tweaks – Compositing. 99 | 100 | ### Show Desktop 101 | 102 | Ctrl + Alt + D 103 | 104 | ## Workspace Shortcuts 105 | 106 | **NOTE**: You can have as many workspaces as you like. When the documentation refers to moving "left" or "right", it means referring to the workspace immediately to the left or right of your current workspace. For example, if you are currently on Workspace 3, moving to the left workspace would switch you to Workspace 2. Moving to the right would shift you to Workspace 4, etc. 107 | 108 | ### Switch to left workspace 109 | 110 | Ctrl + Alt + Left Arrow 111 | 112 | ### Switch to right workspace 113 | 114 | Ctrl + Alt + Right Arrow 115 | 116 | ### Send current window to previous workspace 117 | 118 | Ctrl + Alt + Home 119 | 120 | ### Send current window to next workspace 121 | 122 | Ctrl + Alt + End 123 | 124 | -------------------------------------------------------------------------------- /_Sidebar.md: -------------------------------------------------------------------------------- 1 | [Home](https://github.com/kororaproject/kp-documentation/wiki) 2 | + [Development Notes](https://github.com/kororaproject/kp-documentation/wiki/Development-Notes) 3 | + [Getting Korora](https://github.com/kororaproject/kp-documentation/wiki/Getting-Korora) 4 | + [Creating Bootable Media](https://github.com/kororaproject/kp-documentation/wiki/Creating-Bootable-Media) 5 | + [Which Desktop for Your Korora](https://github.com/kororaproject/kp-documentation/wiki/Which-Desktop-for-Your-Korora) 6 | + [Installing Korora](https://github.com/kororaproject/kp-documentation/wiki/Installing-Korora) 7 | + [Installing Korora - Video Guide](https://github.com/kororaproject/kp-documentation/wiki/Korora-Install-How-To) 8 | + [Using Korora](https://github.com/kororaproject/kp-documentation/wiki/Using-Korora) 9 | + [Updating Korora](https://github.com/kororaproject/kp-documentation/wiki/Updating-Korora) 10 | + [Keeping Current Package Versions](https://github.com/kororaproject/kp-documentation/wiki/Keeping-Current-Package-Versions) 11 | + [Updating Via Command Line](https://github.com/kororaproject/kp-documentation/wiki/Updating-Via-command-Line) 12 | + [Updating With Yumex](https://github.com/kororaproject/kp-documentation/wiki/Updating-With-Yumex) 13 | + [Upgrading Korora](https://github.com/kororaproject/kp-documentation/wiki/Upgrading-Korora) 14 | + [Upgrading - Known Issues](https://github.com/kororaproject/kp-documentation/wiki/Upgrading-Known-Issues) 15 | + [Bootloader](https://github.com/kororaproject/kp-documentation/wiki/Bootloader) 16 | + [GRUB 2 configuration and customisation](https://github.com/kororaproject/kp-documentation/wiki/GRUB-2-configuration-and-customisation) 17 | + [LightDM](https://github.com/kororaproject/kp-documentation/wiki/LightDM) 18 | + [Autologin in LightDM](https://github.com/kororaproject/kp-documentation/wiki/Autologin-in-LightDM) 19 | + [Automatically Unlock the Keyring when Logging In](https://github.com/kororaproject/kp-documentation/wiki/Automatically-Unlock-the-Keyring-when-Logging-In) 20 | + [LightDM Greeter Settings](https://github.com/kororaproject/kp-documentation/wiki/LightDM-Greeter-Settings) 21 | + [Screen Locking with Light Locker](https://github.com/kororaproject/kp-documentation/wiki/Screen-Locking-with-Light-Locker) 22 | + [Desktop Specific](https://github.com/kororaproject/kp-documentation/wiki/Desktop-Specific) 23 | + [Cinnamon](https://github.com/kororaproject/kp-documentation/wiki/Cinnamon) 24 | + [Autologin in Cinnamon](https://github.com/kororaproject/kp-documentation/wiki/Autologin-In-Cinnamon) 25 | + [Keyboard Shortcuts](https://github.com/kororaproject/kp-documentation/wiki/Cinnamon-Shortcuts) 26 | + [KDE Plasma](https://github.com/kororaproject/kp-documentation/wiki/KDE-Plasma) 27 | + [Autologin in KDE Plasma](https://github.com/kororaproject/kp-documentation/wiki/Autologin-In-KDE-Plasma) 28 | + [Mate](https://github.com/kororaproject/kp-documentation/wiki/Mate) 29 | + [Autologin in Mate](https://github.com/kororaproject/kp-documentation/wiki/Autologin-In-Mate) 30 | + [Xfce](https://github.com/kororaproject/kp-documentation/wiki/Xfce) 31 | + [Autologin in Xfce](https://github.com/kororaproject/kp-documentation/wiki/Autologin-In-Xfce) 32 | + [Updating Xfce](https://github.com/kororaproject/kp-documentation/wiki/Updating-Xfce) 33 | + [Xfce Panel Switch](https://github.com/kororaproject/kp-documentation/wiki/Xfce-Panel-Switch) 34 | + [Xfce Terminal Dropdown Option](https://github.com/kororaproject/kp-documentation/wiki/Xfce-Terminal) 35 | + [General](https://github.com/kororaproject/kp-documentation/wiki/General) 36 | + [Accessing A Text Console](https://github.com/kororaproject/kp-documentation/wiki/Accessing-Text-Console) 37 | + [Installing Google Chrome](https://github.com/kororaproject/kp-documentation/wiki/Installing-Google-Chrome) 38 | + [Installing Oracle's Java](https://github.com/kororaproject/kp-documentation/wiki/Installing-Oracle-Java) 39 | + [Installing Other Desktops](https://github.com/kororaproject/kp-documentation/wiki/Installing-Other-Desktops) 40 | + [Installing Skype](https://github.com/kororaproject/kp-documentation/wiki/Installing-Skype) 41 | + [PulseAudio Volume Control (pauvcontrol)](https://github.com/kororaproject/kp-documentation/wiki/Pulse-Audio) 42 | + [QT Theming On GTK Desktops](https://github.com/kororaproject/kp-documentation/wiki/Qt-Theming) 43 | + [Solving Audio Issues](https://github.com/kororaproject/kp-documentation/wiki/Solving-Audio-Issues) 44 | + [Sudo](https://github.com/kororaproject/kp-documentation/wiki/Sudo) 45 | + [Working with Archives](https://github.com/kororaproject/kp-documentation/wiki/Working-With-Archives) 46 | + [Getting help with Korora](https://github.com/kororaproject/kp-documentation/wiki/Getting-Help-With-Korora) 47 | + [Fpaste](https://github.com/kororaproject/kp-documentation/wiki/Fpaste) 48 | + [Troubleshooting Tips](https://github.com/kororaproject/kp-documentation/wiki/Troubleshooting-Tips) 49 | + [Using Engage](https://github.com/kororaproject/kp-documentation/wiki/Using-Engage) 50 | + [Developing For Korora](https://github.com/kororaproject/kp-documentation/wiki/Developing-For-Korora) 51 | + [Contributing To Documentation](https://github.com/kororaproject/kp-documentation/wiki/Contributing-To-Documentation) 52 | + [Planned Documentation](https://github.com/kororaproject/kp-documentation/wiki/Planned-Documentation) 53 | + [Contributing Via GitHub ](https://github.com/kororaproject/kp-documentation/wiki/Contribution-Guidelines) 54 | + [ISO Testing](https://github.com/kororaproject/kp-documentation/wiki/oso-Testing) 55 | + [Using the Korora Packaging Tool, kp](https://github.com/kororaproject/kp-documentation/wiki/Using-Kp) 56 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Xfce-Tour-of-Software.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Tour of Xfce Software ("I Need a Program That Does This")](#tour-of-xfce-software-i-need-a-program-that-does-this) 4 | - [Office Applications](#office-applications) 5 | - [Image Editor](#image-editor) 6 | - [Image Viewers](#image-viewers) 7 | - [PDF Readers](#pdf-readers) 8 | - [E-Readers](#e-readers) 9 | - [RSS Reader](#rss-reader) 10 | - [Scanners](#scanners) 11 | - [Screen Capture Tools](#screen-capture-tools) 12 | - [Multimedia Players](#multimedia-players) 13 | - [Multimedia Ripping and Conversion](#multimedia-ripping-and-conversion) 14 | - [Desktop Recording](#desktop-recording) 15 | - [Sound and Video Editing](#sound-and-video-editing) 16 | - [Internet](#internet) 17 | - [E-Mail](#e-mail) 18 | - [Audiovisual Communication](#audiovisual-communication) 19 | - [Chat Applications](#chat-applications) 20 | - [Torrent Client](#torrent-client) 21 | - [System Applications](#system-applications) 22 | 23 | 24 | 25 | 26 | # Tour of Xfce Software ("I Need a Program That Does This") 27 | 28 | One of the core aims of the Korora Project is to provide an out-of-box Linux experience that can take care of the average's users daily needs with entirely free software. To save you the trouble of digging through every preinstalled application, we have compiled a list of the prepackaged applications within each version of Korora that fulfill a specific purpose. This will hopefully save you some trouble from immediately downloading more software when the right tool may already be installed. 29 | 30 | Xfce largely uses GNOME apps among its inventory of preinstalled applications. However, a handful of Xfce-specific applications are used as well, such as Xfce's in-house image viewer, ristretto. 31 | 32 | On top of this, there are additional packages added by Korora. 33 | 34 | 35 | ## Office Applications 36 | **PURPOSE**: I Need To Edit Some Documents 37 | - [LibreOffice Writer](https://www.libreoffice.org/discover/writer/) (Document Editor, like Microsoft Word) 38 | - [LibreOffice Calc](https://www.libreoffice.org/discover/calc/) (Spreadsheet editor, like Microsoft Excel) 39 | - [LibreOffice Draw](https://www.libreoffice.org/discover/draw/) (Image and flowchart editor, like Microsoft Visio) 40 | - [LibreOffice Impress](https://www.libreoffice.org/discover/impress/) (Presentation and slide editor, like Microsoft Powerpoint) 41 | - [Project Management](https://wiki.gnome.org/Apps/Planner) (plan projects) 42 | 43 | 44 | ## Image Editor 45 | **PURPOSE**: I Need to Touch Up Some Photos 46 | - [GIMP](https://www.gimp.org/) 47 | - [Inkscape](https://inkscape.org/) (Vector graphics editor) 48 | 49 | 50 | ## Image Viewers 51 | **PURPOSE**: I Just Want to Look at Some Photos 52 | - [ristretto](http://goodies.xfce.org/projects/applications/ristretto) (Under the name "Ristretto Image Viewer") 53 | - [Shotwell](https://wiki.gnome.org/Apps/Shotwell) (Photo Manger) 54 | 55 | 56 | ## PDF Readers 57 | - [Evince](https://wiki.gnome.org/Apps/Evince) (Under the name "Document Viewer") 58 | 59 | 60 | ## E-Readers 61 | - [FBReader](https://fbreader.org/) (E-book and Comic Book reader) 62 | - [Evince](https://wiki.gnome.org/Apps/Evince) (Under the name "Document Viewer") 63 | 64 | 65 | ## RSS Reader 66 | - [Liferea](http://lzone.de/liferea/) 67 | 68 | 69 | ## Scanners 70 | **PURPOSE**: I Need to Scan a Document 71 | - [Simple Scan](https://launchpad.net/simple-scan) 72 | 73 | 74 | ## Screen Capture Tools 75 | **PURPOSE**: I Need to Take a Screenshot 76 | - [Xfce4 Screenshooter](http://goodies.xfce.org/projects/applications/xfce4-screenshooter) (Under the name "Screenshot") 77 | 78 | 79 | ## Multimedia Players 80 | **PURPOSE**: I Need to Play Some Music or Video 81 | - [VLC](http://www.videolan.org/) (Audio and Video player; supports most multimedia formats with no additional codecs) 82 | - [Audacious](http://audacious-media-player.org) (Audio player) 83 | 84 | 85 | ## Multimedia Ripping and Conversion 86 | **PURPOSE**: I Need to Rip My CD or DVD 87 | - [Asunder CD Ripper](http://littlesvr.ca/asunder/) 88 | - [Handbrake](https://handbrake.fr) (Transcodes CDs, DVDs, and Blurays) 89 | - [Sound Converter](http://soundconverter.org) (Converts audio files to other formats) 90 | - [Xfburn](http://www.xfce.org/projects/xfburn) (CD Burner) 91 | 92 | 93 | ## Desktop Recording 94 | - [recordMyDesktop](https://sourceforge.net/projects/recordmydesktop/) 95 | 96 | 97 | ## Sound and Video Editing 98 | - [Audacity](http://www.audacityteam.org/) (audio editing program) 99 | - [Pitivi](http://www.pitivi.org/) (video editing program) 100 | 101 | 102 | ## Internet 103 | - [Firefox](https://www.mozilla.org/en-US/firefox/) 104 | 105 | 106 | ## E-Mail 107 | - [Thunderbird](https://www.mozilla.org/en-US/thunderbird/) 108 | 109 | 110 | ## Audiovisual Communication 111 | **PURPOSE**: I Need to Call / Video Conference With Someone 112 | - [Ekiga Softphone](http://www.ekiga.org) 113 | 114 | 115 | ## Chat Applications 116 | - [Pidgin](https://pidgin.im/) (IM app, has compatibility with AIM, Google Talk, XMPP, etc.) 117 | - [HexChat](https://hexchat.github.io/) (IRC Client) 118 | 119 | 120 | ## Torrent Client 121 | - [Transmission](http://www.transmissionbt.com/) 122 | 123 | 124 | ## System Applications 125 | - [GParted](http://gparted.org) (Modify and delete system partitions) 126 | - [Backups](https://launchpad.net/deja-dup) (Create a backup of your system) 127 | - [ownCloud](https://owncloud.org/) (Self-hosted file sync and share platform) 128 | - [Redshift](http://jonls.dk/redshift/) (Screen temperature adjustment / blue-light reduction tool) -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/Cinnamon-Tour-of-Software.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Tour of Cinnamon Software ("I Need a Program That Does This")](#tour-of-cinnamon-software-i-need-a-program-that-does-this) 4 | - [Office Applications](#office-applications) 5 | - [Image Editor](#image-editor) 6 | - [Image Viewers](#image-viewers) 7 | - [PDF Readers](#pdf-readers) 8 | - [E-Readers](#e-readers) 9 | - [RSS Reader](#rss-reader) 10 | - [Scanners](#scanners) 11 | - [Screen Capture Tools](#screen-capture-tools) 12 | - [Multimedia Players](#multimedia-players) 13 | - [Multimedia Ripping and Conversion](#multimedia-ripping-and-conversion) 14 | - [Desktop Recording](#desktop-recording) 15 | - [Sound and Video Editing](#sound-and-video-editing) 16 | - [Internet](#internet) 17 | - [E-Mail](#e-mail) 18 | - [Audiovisual Communication](#audiovisual-communication) 19 | - [Chat Applications](#chat-applications) 20 | - [Torrent Client](#torrent-client) 21 | - [System Applications](#system-applications) 22 | 23 | 24 | 25 | 26 | # Tour of Cinnamon Software ("I Need a Program That Does This") 27 | 28 | One of the core aims of the Korora Project is to provide an out-of-box Linux experience that can take care of the average's users daily needs with entirely free software. To save you the trouble of digging through every preinstalled application, we have compiled a list of the prepackaged applications within each version of Korora that fulfill a specific purpose. This will hopefully save you some trouble from immediately downloading more software when the right tool may already be installed. 29 | 30 | The Cinnamon desktop pulls most of its preinstalled programs from GNOME, with a handful of other additions from the upstream [Linux Mint](https://linuxmint.com/) project that develops the Cinnamon desktop. There are also some programs added by Korora. 31 | 32 | 33 | ## Office Applications 34 | **PURPOSE**: I Need To Edit Some Documents 35 | - [LibreOffice Writer](https://www.libreoffice.org/discover/writer/) (Document Editor, like Microsoft Word) 36 | - [LibreOffice Calc](https://www.libreoffice.org/discover/calc/) (Spreadsheet editor, like Microsoft Excel) 37 | - [LibreOffice Draw](https://www.libreoffice.org/discover/draw/) (Image and flowchart editor, like Microsoft Visio) 38 | - [LibreOffice Impress](https://www.libreoffice.org/discover/impress/) (Presentation and slide editor, like Microsoft Powerpoint) 39 | - [Project Management](https://wiki.gnome.org/Apps/Planner) (plan projects) 40 | - [GNote](https://wiki.gnome.org/Apps/Gnote) (write short sticky-notes of information) 41 | 42 | 43 | ## Image Editor 44 | **PURPOSE**: I Need to Touch Up Some Photos 45 | - [GIMP](https://www.gimp.org/) 46 | - [Darktable](http://www.darktable.org/) (Photography and RAW photo developer) 47 | - [Inkscape](https://inkscape.org/) (Vector graphics editor) 48 | - [Cura LulzBot Edition](https://www.lulzbot.com/cura) (3D Printing software) 49 | 50 | 51 | ## Image Viewers 52 | **PURPOSE**: I Just Want to Look at Some Photos 53 | - [Eye of GNOME](https://wiki.gnome.org/Apps/EyeOfGnome) (Under the name "Image Viewer") 54 | - [Shotwell](https://wiki.gnome.org/Apps/Shotwell) (Photo Manger) 55 | 56 | 57 | ## PDF Readers 58 | - [Evince](https://wiki.gnome.org/Apps/Evince) (Under the name "Document Viewer") 59 | 60 | 61 | ## E-Readers 62 | - [FBReader](https://fbreader.org/) (E-book and Comic Book reader) 63 | - [Evince](https://wiki.gnome.org/Apps/Evince) (Under the name "Document Viewer") 64 | 65 | 66 | ## RSS Reader 67 | - [Liferea](http://lzone.de/liferea/) 68 | 69 | 70 | ## Scanners 71 | **PURPOSE**: I Need to Scan a Document 72 | - [Simple Scan](https://launchpad.net/simple-scan) 73 | 74 | 75 | ## Screen Capture Tools 76 | **PURPOSE**: I Need to Take a Screenshot 77 | - [gnome-screenshot](https://git.gnome.org/browse/gnome-screenshot/) (Under the name "Screenshot") 78 | 79 | 80 | ## Multimedia Players 81 | **PURPOSE**: I Need to Play Some Music or Video 82 | - [VLC](http://www.videolan.org/) (Audio and Video player; supports most multimedia formats with no additional codecs) 83 | - [Rhythmbox](https://wiki.gnome.org/Apps/Rhythmbox/) (Audio player) 84 | 85 | 86 | ## Multimedia Ripping and Conversion 87 | **PURPOSE**: I Need to Rip My CD or DVD 88 | - [Brasero](https://wiki.gnome.org/Apps/Brasero) (copies and burns CDs and DVDs) 89 | - [Handbrake](https://handbrake.fr) (Transcodes CDs, DVDs, and Blurays) 90 | - [Sound Juicer](https://wiki.gnome.org/Apps/SoundJuicer) (rips audio CDs to your hard-drive) 91 | - [Sound Converter](http://soundconverter.org) (Converts audio files to other formats) 92 | 93 | 94 | ## Desktop Recording 95 | - [recordMyDesktop](https://sourceforge.net/projects/recordmydesktop/) 96 | 97 | 98 | ## Sound and Video Editing 99 | - [Audacity](http://www.audacityteam.org/) (audio editing program) 100 | - [Pitivi](http://www.pitivi.org/) (video editing program) 101 | 102 | 103 | ## Internet 104 | - [Firefox](https://www.mozilla.org/en-US/firefox/) 105 | 106 | 107 | ## E-Mail 108 | - [Thunderbird](https://www.mozilla.org/en-US/thunderbird/) 109 | 110 | 111 | ## Audiovisual Communication 112 | **PURPOSE**: I Need to Call / Video Conference With Someone 113 | - [Ekiga Softphone](http://www.ekiga.org) 114 | 115 | 116 | ## Chat Applications 117 | - [Pidgin](https://pidgin.im/) (IM app, has compatibility with AIM, Google Talk, XMPP, etc.) 118 | - [HexChat](https://hexchat.github.io/) (IRC Client) 119 | 120 | 121 | ## Torrent Client 122 | - [Transmission](http://www.transmissionbt.com/) 123 | 124 | 125 | ## System Applications 126 | - [GParted](http://gparted.org) (Modify and delete system partitions) 127 | - [Backups](https://launchpad.net/deja-dup) (Create a backup of your system) 128 | - [ownCloud](https://owncloud.org/) (Self-hosted file sync and share platform) 129 | - [Redshift](http://jonls.dk/redshift/) (Screen temperature adjustment / blue-light reduction tool) -------------------------------------------------------------------------------- /DevelopingKorora/Using-Kp.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Using the Korora Packaging tool, kp](#using-the-korora-packaging-tool-kp) 6 | - [Requirements](#requirements) 7 | - [Add user to the mock group](#add-user-to-the-mock-group) 8 | - [Creating a ssh key and adding it to your Git account](#creating-a-ssh-key-and-adding-it-to-your-git-account) 9 | - [SSH preparation](#ssh-preparation) 10 | - [Get code and setup](#get-code-and-setup) 11 | - [Checkout a version](#checkout-a-version) 12 | - [Sync the package list](#sync-the-package-list) 13 | - [Build first packages](#build-first-packages) 14 | - [Create a dnf repository](#create-a-dnf-repository) 15 | - [Build all packages](#build-all-packages) 16 | - [Create final repository](#create-final-repository) 17 | - [Create an image](#create-an-image) 18 | - [Boot your image](#boot-your-image) 19 | 20 | 21 | 22 | 23 | # Using the Korora Packaging tool, kp 24 | 25 | Korora Package tool (called _kp_) is a bunch of shell scripts that wrap standard system commands (like git, mock and livecd-creator) to build Korora packages and images. Users should be running Korora or Fedora already, however which specific version generally doesn't matter. 26 | 27 | Our code lives on GitHub, however you don't need an account in order to build packages as everything is publicly available. Building the packages and images is local to your machine, however if you wish to contribute fixes, please sign up for an account (you can use this to also log into Engage). You will then have read-only access to the Korora repositories over SSH protocol, but can fork our code and commit changes to your own repositories, then send us a pull request! :-) 28 | 29 | 30 | ## Requirements 31 | 32 | Before we start setting up kp we need to install a few packages that are important and necessary to build our packages and live-iso later on. 33 | 34 | ``` 35 | sudo dnf install createrepo livecd-tools mock pykickstart rpm-sign 36 | 37 | ``` 38 | 39 | 40 | ## Add user to the mock group 41 | 42 | Add yourself as user to the mock group. You replace {USER} with your own user name. 43 | 44 | ``` 45 | sudo usermod -a -G mock ${USER} && newgrp mock 46 | ``` 47 | 48 | 49 | ## Creating a ssh key and adding it to your Git account 50 | 51 | Simply follow the guide in this link on how to create a ssh key and add it to your Git account: [https://help.github.com/articles/generating-ssh-keys](https://help.github.com/articles/generating-ssh-keys/) 52 | 53 | 54 | ## SSH preparation 55 | 56 | If you're using SSH, then set up the ssh-agent to cache your passphrase (if you use one) 57 | 58 | ``` 59 | eval $(ssh-agent &) 60 | ssh-add 61 | ``` 62 | 63 | 64 | ## Get code and setup 65 | 66 | Make a directory somewhere to put the Korora kp code: 67 | 68 | ``` 69 | mkdir -p ~/code/korora 70 | cd ~/code/korora 71 | ``` 72 | 73 | Get the code: 74 | 75 | >Developers should use ssh instead of https, git@github.com:kororaproject/kp.git 76 | 77 | ``` 78 | git clone https://github.com/kororaproject/kp.git 79 | cd kp 80 | ``` 81 | 82 | Create your config file from the example config (it should work out of the box): 83 | 84 | Developers should set the protocol to GIT_PROTOCOL="ssh" and set their KP_DEV_ACCOUNT and KP_DEV_EMAIL details. 85 | 86 | ``` 87 | cp kp.conf.example kp.conf 88 | ``` 89 | 90 | Initialise your kp directories: 91 | 92 | >This creates the skeleton directory structure under ~/code/korora/kp/build/{conf,log,packages,release,repository} 93 | 94 | ``` 95 | ./kp init 96 | ``` 97 | 98 | 99 | ## Checkout a version 100 | 101 | Checkout a revision, master defaults to the current release, else specify a branch like k21 for a previous release: 102 | 103 | >This clones the config repository for each available package ~/code/korora/kp/build/packages 104 | 105 | ``` 106 | ./kp checkout --release master 107 | ``` 108 | 109 | 110 | ## Sync the package list 111 | 112 | Next, sync down the packages repository, which will let kp know about available packages: 113 | 114 | >This clones the kp-config repository to ~/code/korora/kp/build/conf 115 | 116 | ``` 117 | ./kp sync 118 | ``` 119 | 120 | 121 | ## Build first packages 122 | 123 | To build packages, we need to put our machine temporarily into SELinux permissive mode: 124 | 125 | ``` 126 | sudo setenforce 0 127 | ``` 128 | 129 | Build core packages (binary and source), korora-release and korora-repos: 130 | 131 | >This creates packages under ~/code/korora/kp/build/repository/23/{source,x86_64}/ 132 | 133 | >Note that we are building these against Fedora, as we do not yet have the required local Korora repository 134 | 135 | ``` 136 | ./kp build --arch x86_64 --releasever 23 --distribution fedora korora-release korora-repos 137 | ``` 138 | 139 | 140 | ## Create a dnf repository 141 | 142 | Turn the directories with your packages into usable dnf repositories, which we will then use to build the remaining packages: 143 | 144 | >kp can sign your rpms if you specify a GPG key in your config file, however by default we will not (--no-sign option) 145 | 146 | ``` 147 | ./kp repository --releasever 23 --no-sign 148 | ``` 149 | 150 | 151 | ## Build all packages 152 | 153 | Build the remaining packages, using your new korora repository as the base: 154 | 155 | ``` 156 | ./kp build --arch x86_64 --releasever 23 --distribution korora 157 | ``` 158 | 159 | 160 | ## Create final repository 161 | 162 | Re-build dnf repository with all the new packages: 163 | 164 | 165 | ``` 166 | ./kp repository --releasever 23 167 | ``` 168 | 169 | 170 | 171 | ## Create an image 172 | 173 | Create a live image: 174 | 175 | >This must be run as root and will create the ISO image in your kp dir ~/code/korora/kp 176 | 177 | ``` 178 | sudo ./kp release --release-version 23 --release-arch x86_64 --release-title "My Korora" \ 179 | --release-codename "custom" --desktop GNOME korora-gnome 180 | ``` 181 | 182 | 183 | ## Boot your image! 184 | 185 | Now you can try to boot that with KVM or a real machine! 186 | -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/GNOME-Tour-of-Software.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Tour of GNOME Software ("I Need a Program That Does This")](#tour-of-gnome-software-i-need-a-program-that-does-this) 4 | - [Office Applications](#office-applications) 5 | - [Image Editor](#image-editor) 6 | - [Image Viewers](#image-viewers) 7 | - [PDF Readers](#pdf-readers) 8 | - [E-Readers](#e-readers) 9 | - [RSS Reader](#rss-reader) 10 | - [Scanners](#scanners) 11 | - [Screen Capture Tools](#screen-capture-tools) 12 | - [Multimedia Players](#multimedia-players) 13 | - [Multimedia Ripping and Conversion](#multimedia-ripping-and-conversion) 14 | - [Desktop Recording](#desktop-recording) 15 | - [Sound and Video Editing](#sound-and-video-editing) 16 | - [Internet](#internet) 17 | - [E-Mail](#e-mail) 18 | - [Audiovisual Communication](#audiovisual-communication) 19 | - [Chat Applications](#chat-applications) 20 | - [Torrent Client](#torrent-client) 21 | - [System Applications](#system-applications) 22 | 23 | 24 | 25 | 26 | # Tour of GNOME Software ("I Need a Program That Does This") 27 | 28 | One of the core aims of the Korora Project is to provide an out-of-box Linux experience that can take care of the average's users daily needs with entirely free software. To save you the trouble of digging through every preinstalled application, we have compiled a list of the prepackaged applications within each version of Korora that fulfill a specific purpose. This will hopefully save you some trouble from immediately downloading more software when the right tool may already be installed. 29 | 30 | The GNOME desktop pulls all of its packages from [The GNOME Project](https://www.gnome.org/), its maintainers. These programs are usually built in-house and do not pull "upstream" from anywhere else. 31 | 32 | On top of this, there are additional packages added by Korora. 33 | 34 | 35 | ## Office Applications 36 | **PURPOSE**: I Need To Edit Some Documents 37 | - [LibreOffice Writer](https://www.libreoffice.org/discover/writer/) (Document Editor, like Microsoft Word) 38 | - [LibreOffice Calc](https://www.libreoffice.org/discover/calc/) (Spreadsheet editor, like Microsoft Excel) 39 | - [LibreOffice Draw](https://www.libreoffice.org/discover/draw/) (Image and flowchart editor, like Microsoft Visio) 40 | - [LibreOffice Impress](https://www.libreoffice.org/discover/impress/) (Presentation and slide editor, like Microsoft Powerpoint) 41 | - [Project Management](https://wiki.gnome.org/Apps/Planner) (plan projects) 42 | - [GNote](https://wiki.gnome.org/Apps/Gnote) (write short sticky-notes of information) 43 | - [gedit](http://www.gedit.org) (Under the name "Text Editor") 44 | 45 | 46 | ## Image Editor 47 | **PURPOSE**: I Need to Touch Up Some Photos 48 | - [GIMP](https://www.gimp.org/) 49 | - [Darktable](http://www.darktable.org/) (Photography and RAW photo developer) 50 | - [Inkscape](https://inkscape.org/) (Vector graphics editor) 51 | - [Cura LulzBot Edition](https://www.lulzbot.com/cura) (3D Printing software) 52 | 53 | 54 | ## Image Viewers 55 | **PURPOSE**: I Just Want to Look at Some Photos 56 | - [Eye of GNOME](https://wiki.gnome.org/Apps/EyeOfGnome) (Under the name "Image Viewer") 57 | - [Shotwell](https://wiki.gnome.org/Apps/Shotwell) (Photo Manger) 58 | 59 | 60 | ## PDF Readers 61 | - [Evince](https://wiki.gnome.org/Apps/Evince) (Under the name "Document Viewer") 62 | 63 | 64 | ## E-Readers 65 | - [FBReader](https://fbreader.org/) (E-book and Comic Book reader) 66 | - [Evince](https://wiki.gnome.org/Apps/Evince) (Under the name "Document Viewer") 67 | 68 | 69 | ## RSS Reader 70 | - [Liferea](http://lzone.de/liferea/) 71 | 72 | 73 | ## Scanners 74 | **PURPOSE**: I Need to Scan a Document 75 | - [Simple Scan](https://launchpad.net/simple-scan) 76 | 77 | 78 | ## Screen Capture Tools 79 | **PURPOSE**: I Need to Take a Screenshot 80 | - [gnome-screenshot](https://git.gnome.org/browse/gnome-screenshot/) (Under the name "Screenshot") 81 | 82 | 83 | ## Multimedia Players 84 | **PURPOSE**: I Need to Play Some Music or Video 85 | - [VLC](http://www.videolan.org/) (Audio and Video player; supports most multimedia formats with no additional codecs) 86 | - [Rhythmbox](https://wiki.gnome.org/Apps/Rhythmbox/) (Audio player) 87 | 88 | 89 | ## Multimedia Ripping and Conversion 90 | **PURPOSE**: I Need to Rip My CD or DVD 91 | - [Brasero](https://wiki.gnome.org/Apps/Brasero) (copies and burns CDs and DVDs) 92 | - [Handbrake](https://handbrake.fr) (Transcodes CDs, DVDs, and Blurays) 93 | - [Sound Juicer](https://wiki.gnome.org/Apps/SoundJuicer) (rips audio CDs to your hard-drive) 94 | - [Sound Converter](http://soundconverter.org) (Converts audio files to other formats) 95 | 96 | 97 | ## Desktop Recording 98 | - [recordMyDesktop](https://sourceforge.net/projects/recordmydesktop/) 99 | 100 | 101 | ## Sound and Video Editing 102 | - [Audacity](http://www.audacityteam.org/) (audio editing program) 103 | - [Pitivi](http://www.pitivi.org/) (video editing program) 104 | 105 | 106 | ## Internet 107 | - [Firefox](https://www.mozilla.org/en-US/firefox/) 108 | 109 | 110 | ## E-Mail 111 | - [Evolution](https://wiki.gnome.org/Apps/Evolution) 112 | 113 | 114 | ## Audiovisual Communication 115 | **PURPOSE**: I Need to Call / Video Conference With Someone 116 | - [Ekiga Softphone](http://www.ekiga.org) 117 | 118 | 119 | ## Chat Applications 120 | - [Empathy](https://wiki.gnome.org/Apps/Empathy) (IM app, has compatibility with AIM, Google Talk, XMPP, etc.) 121 | - [HexChat](https://hexchat.github.io/) (IRC Client) 122 | 123 | 124 | ## Torrent Client 125 | - [Transmission](http://www.transmissionbt.com/) 126 | 127 | 128 | ## System Applications 129 | - [GParted](http://gparted.org) (Modify and delete system partitions) 130 | - [Backups](https://launchpad.net/deja-dup) (Create a backup of your system) 131 | - [ownCloud](https://owncloud.org/) (Self-hosted file sync and share platform) 132 | - [Redshift](http://jonls.dk/redshift/) (Screen temperature adjustment / blue-light reduction tool) -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/MATE-Tour-of-Software.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Tour of MATE Software ("I Need a Program That Does This")](#tour-of-mate-software-i-need-a-program-that-does-this) 4 | - [Office Applications](#office-applications) 5 | - [Image Editor](#image-editor) 6 | - [Image Viewers](#image-viewers) 7 | - [PDF Readers](#pdf-readers) 8 | - [E-Readers](#e-readers) 9 | - [RSS Reader](#rss-reader) 10 | - [Scanners](#scanners) 11 | - [Screen Capture Tools](#screen-capture-tools) 12 | - [Multimedia Players](#multimedia-players) 13 | - [Multimedia Ripping and Conversion](#multimedia-ripping-and-conversion) 14 | - [Desktop Recording](#desktop-recording) 15 | - [Sound and Video Editing](#sound-and-video-editing) 16 | - [Internet](#internet) 17 | - [E-Mail](#e-mail) 18 | - [Audiovisual Communication](#audiovisual-communication) 19 | - [Chat Applications](#chat-applications) 20 | - [Torrent Client](#torrent-client) 21 | - [System Applications](#system-applications) 22 | 23 | 24 | 25 | 26 | # Tour of MATE Software ("I Need a Program That Does This") 27 | 28 | One of the core aims of the Korora Project is to provide an out-of-box Linux experience that can take care of the average's users daily needs with entirely free software. To save you the trouble of digging through every preinstalled application, we have compiled a list of the prepackaged applications within each version of Korora that fulfill a specific purpose. This will hopefully save you some trouble from immediately downloading more software when the right tool may already be installed. 29 | 30 | The MATE Desktop largely uses GNOME applications for its inventory of existing programs. However, as MATE is itself a fork of GNOME 2, MATE maintains several forks of GNOME apps in order to better maintain their aesthetic within the classic GNOME 2/desktop paradigm. These include MATE's own Image Viewer and Document Viewer, based on upstream GNOME programs. 31 | 32 | On top of this, there are additional packages added by Korora. 33 | 34 | 35 | ## Office Applications 36 | **PURPOSE**: I Need To Edit Some Documents 37 | - [LibreOffice Writer](https://www.libreoffice.org/discover/writer/) (Document Editor, like Microsoft Word) 38 | - [LibreOffice Calc](https://www.libreoffice.org/discover/calc/) (Spreadsheet editor, like Microsoft Excel) 39 | - [LibreOffice Draw](https://www.libreoffice.org/discover/draw/) (Image and flowchart editor, like Microsoft Visio) 40 | - [LibreOffice Impress](https://www.libreoffice.org/discover/impress/) (Presentation and slide editor, like Microsoft Powerpoint) 41 | - [Project Management](https://wiki.gnome.org/Apps/Planner) (plan projects) 42 | - [GNote](https://wiki.gnome.org/Apps/Gnote) (write short sticky-notes of information) 43 | - [Pluma](https://github.com/mate-desktop/pluma) 44 | 45 | 46 | ## Image Editor 47 | **PURPOSE**: I Need to Touch Up Some Photos 48 | - [GIMP](https://www.gimp.org/) 49 | - [Inkscape](https://inkscape.org/) (Vector graphics editor) 50 | - [Cura LulzBot Edition](https://www.lulzbot.com/cura) (3D Printing software) 51 | - [MATE Color Selection](http://mate-desktop.org/) 52 | 53 | 54 | ## Image Viewers 55 | **PURPOSE**: I Just Want to Look at Some Photos 56 | - [Eye of MATE Image Viewer](https://github.com/mate-desktop/eom) 57 | - [Shotwell](https://wiki.gnome.org/Apps/Shotwell) (Photo Manger) 58 | 59 | 60 | ## PDF Readers 61 | - [Atril Document Viewer](https://github.com/mate-desktop/atril) (Fork of Evince) 62 | 63 | 64 | ## E-Readers 65 | - [FBReader](https://fbreader.org/) (E-book and Comic Book reader) 66 | - [Atril Document Viewer](https://github.com/mate-desktop/atril) (Fork of Evince) 67 | 68 | 69 | ## RSS Reader 70 | - [Liferea](http://lzone.de/liferea/) 71 | 72 | 73 | ## Scanners 74 | **PURPOSE**: I Need to Scan a Document 75 | - [Simple Scan](https://launchpad.net/simple-scan) 76 | 77 | 78 | ## Screen Capture Tools 79 | **PURPOSE**: I Need to Take a Screenshot 80 | - [mate-screenshot](https://github.com/mate-desktop/mate-utils) (Under the name "Take Screenshot") 81 | 82 | 83 | ## Multimedia Players 84 | **PURPOSE**: I Need to Play Some Music or Video 85 | - [VLC](http://www.videolan.org/) (Audio and Video player; supports most multimedia formats with no additional codecs) 86 | - [Audacious](http://audacious-media-player.org) (Audio player) 87 | 88 | 89 | ## Multimedia Ripping and Conversion 90 | **PURPOSE**: I Need to Rip My CD or DVD 91 | - [Asunder CD Ripper](http://littlesvr.ca/asunder/) 92 | - [Handbrake](https://handbrake.fr) (Transcodes CDs, DVDs, and Blurays) 93 | - [Sound Converter](http://soundconverter.org) (Converts audio files to other formats) 94 | - [Xfburn](http://www.xfce.org/projects/xfburn) (CD Burner) 95 | 96 | 97 | ## Desktop Recording 98 | - [recordMyDesktop](https://sourceforge.net/projects/recordmydesktop/) 99 | 100 | 101 | ## Sound and Video Editing 102 | - [Audacity](http://www.audacityteam.org/) (audio editing program) 103 | - [Pitivi](http://www.pitivi.org/) (video editing program) 104 | 105 | 106 | ## Internet 107 | - [Firefox](https://www.mozilla.org/en-US/firefox/) 108 | 109 | 110 | ## E-Mail 111 | - [Thunderbird](https://www.mozilla.org/en-US/thunderbird/) 112 | 113 | 114 | ## Audiovisual Communication 115 | **PURPOSE**: I Need to Call / Video Conference With Someone 116 | - [Ekiga Softphone](http://www.ekiga.org) 117 | 118 | 119 | ## Chat Applications 120 | - [Pidgin](https://pidgin.im/) (IM app, has compatibility with AIM, Google Talk, XMPP, etc.) 121 | - [HexChat](https://hexchat.github.io/) (IRC Client) 122 | 123 | 124 | ## Torrent Client 125 | - [Transmission](http://www.transmissionbt.com/) 126 | 127 | 128 | ## System Applications 129 | - [GParted](http://gparted.org) (Modify and delete system partitions) 130 | - [Backups](https://launchpad.net/deja-dup) (Create a backup of your system) 131 | - [ownCloud](https://owncloud.org/) (Self-hosted file sync and share platform) 132 | - [Redshift](http://jonls.dk/redshift/) (Screen temperature adjustment / blue-light reduction tool) -------------------------------------------------------------------------------- /UsingKorora/Working-With-Archives.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Working with Archives](#working-with-archives) 6 | - [Archive Types and Extensions](#archive-types-and-extensions) 7 | - [Tar](#tar) 8 | - [Zip](#zip) 9 | - [Within the File Manager](#within-the-file-manager) 10 | - [Creating an Archive](#creating-an-archive) 11 | - [Extracting an Archive](#extracting-an-archive) 12 | - [Within the Terminal](#within-the-terminal) 13 | - [Creating an Archive](#creating-an-archive-1) 14 | - [Extracting an Archive](#extracting-an-archive-1) 15 | 16 | 17 | 18 | 19 | # Working with Archives 20 | 21 | At some point, you will probably have to deal with a compressed archive file. Archives allow you to lump multiple files or directories together into a single file, making it easier for transportation. 22 | 23 | 24 | ## Archive Types and Extensions 25 | 26 | Because there are multiple types of archives (they often vary by the kind of compression algorithm used), the easiest way to distinguish one over the other is via its file extension. Below are some of the most common archive formats used and their extensions: 27 | 28 | Archive Format | Extension 29 | --- | --- 30 | compress | .Z 31 | zip | .zip 32 | lzip | .lz 33 | xz | .xz 34 | lzma | .lzma 35 | bzip | .bz2 36 | tar | .tar 37 | tar ( gzip compression) | .gz, .tgz 38 | tar (bzip2 compression) | .bz2 39 | 40 | 41 | ### Tar 42 | 43 | The most common type of archive in the UNIX/Linux world is the tape archive or **tar** file, sometimes called a **tarball**. tar is heavily used due to its history and flexibility. While the packaging format will remain the same, the type of compression used on compressed tar archives can be changed at runtime in order to accommodate better compression or better performance. 44 | 45 | 46 | ### Zip 47 | 48 | The zip archive format was originally designed for DOS and Windows systems, and is still used heavily within those operating systems. However, zip archives are readable on Linux as well, and can be easily extracted using the `unzip` command. 49 | 50 | 51 | ## Within the File Manager 52 | 53 | Most File Managers allow direct creation or extraction of recognized archives without needing to enter the Terminal. 54 | 55 | 56 | ### Creating an Archive 57 | To create an archive, highlight a file, a series of files, or a directory, and right click on the selection. Then select the **Compress...** option. You may be prompted for what kind of archive to create, and what kind of compression, if any, to use. 58 | 59 | 60 | ### Extracting an Archive 61 | 62 | To extract an existing archive that you have already created or downloaded, right-click on the archive file inside your File Manager. Select the option **Extract**. If the File Manager recognizes the extension, it will attempt to extract the contents of the archive automatically. If the archive has been protected or encrypted with a password, you may be prompted to enter the password before the archive's contents can be completely extracted. 63 | 64 | Alternatively, your desktop environment likely has an Archive Manager application pre-installed. In which case, simply double-clicking the archive should launch the Archive Manager and allow you to extract its contents. 65 | 66 | 67 | ## Within the Terminal 68 | 69 | Should you ever need to manipulate archives (for instance, if you want to run a program whose installation instructions reads "Untar this package and run the installer script"), it couldn't hurt to be able to do it in a terminal. 70 | 71 | 72 | ### Creating an Archive 73 | 74 | As mentioned previously, the most common archive format is the tarball with some kind of compression. To create a basic tarball, enter the following command: 75 | 76 | tar [options] destination_file inputfile1 inputfile2.... 77 | 78 | For example, to create a tarball called "archive.tar" containing files file1, file2, and file3, issue the following command: 79 | 80 | tar cfv archive.tar file1 file2 file3 81 | 82 | If you want the contents of the archive to be compressed so that they take up less space, you can pass one of the compression flags to the tar command. For instance, to use gzip compression within the tarball, you would type the following: 83 | 84 | tar cfvz archive.tgz file1 file2 file3 85 | 86 | In the above command, we passed a `-z` flag to the tar command so that the program would use `gzip` compression on the archive. We also changed the output file's extension to **.tgz** instead of **.tar** so that it is obvious to anyone looking at the file what kind of compression it uses. 87 | 88 | We could similarly use another algorithm like bzip2 instead of gzip if we want a slightly higher rate of compression: 89 | 90 | tar cfvj archive.bz2 file1 file2 file3 91 | 92 | In this case, we used `-j` instead of `-z` to trigger bzip2 compression, and also changed the extension of the archive to **.bz2**. 93 | 94 | **NOTE**: 95 | Take careful note of the order in which the arguments are passed to the tar command. The destination archive name comes **before** the files that will go into the archive. This may seem to go against many other commands that generally go in the format `command source destination`, but it makes sense when you consider that the tarball is expected to contain multiple files. As such, variable arguments may be thrown at the program without fundamentally changing the syntax. For example: 96 | 97 | tar cfvz archive.tgz file1 file2 file3 98 | tar cfvz archive.tgz file1 file2 directory1 directory2 99 | tar cfvz archive.tgz file1 file2 file3 file4 file5 100 | tar cfvz archive.tgz file* dir* 101 | tar cfvz archive.tgz ./* 102 | 103 | All of the above are valid and maintain consistent syntax, even though the number of files being archived changes. 104 | 105 | 106 | 107 | ### Extracting an Archive 108 | 109 | To extract the contents of a tarball, use the `-x` flag (Short for "e**X**tract"), along with any additional flags necessary to specify the type of compression used. For example, to extract a basic, non-compressed tarball, you would type the following: 110 | 111 | tar xfv archive.tar 112 | 113 | The `-v` flag is not necessary, it simply echoes back the contents of the tarball as it extracts them. If the tarball is compressed, you may need to add an additional flag to the command. For instance, to extract a gzip-compressed .tar.gz/.tgz file, you would add a `-z` flag and use the following command: 114 | 115 | tar xfvz archive.tgz 116 | 117 | To extract a bzip2 tarball, you would add a `-j` and use the following: 118 | 119 | tar xfvj archive.bz2 120 | 121 | **Pro-Tip**: The tar program is usually intelligent enough to figure out what kind of archive it's processing if the archive is in a supported format. And so if you are not concerned about creating tarballs but only need to extract them, you can drop the compression flag and let the tar command figure out which one to use. `tar xfv` will work on a .tar, .tgz, .bz2, and others without explicitly specifying a `-z` or `-j`. So the next time you need to extract a tarball, try just entering the following: 122 | 123 | tar xvf archive.XXX 124 | 125 | where `.XXX` is the extension of the archive. -------------------------------------------------------------------------------- /UsingKorora/DesktopSpecific/KDE-Tour-of-Software.md: -------------------------------------------------------------------------------- 1 | **Table of Contents** 2 | 3 | - [Tour of KDE Plasma Software ("I Need a Program That Does This")](#tour-of-kde-plasma-software-i-need-a-program-that-does-this) 4 | - [Office Applications](#office-applications) 5 | - [Image Editor](#image-editor) 6 | - [Image Viewers](#image-viewers) 7 | - [PDF Readers](#pdf-readers) 8 | - [E-Readers](#e-readers) 9 | - [RSS Reader](#rss-reader) 10 | - [Scanners](#scanners) 11 | - [Screen Capture Tools](#screen-capture-tools) 12 | - [Multimedia Players](#multimedia-players) 13 | - [Multimedia Ripping and Conversion](#multimedia-ripping-and-conversion) 14 | - [Desktop Recording](#desktop-recording) 15 | - [Sound and Video Editing](#sound-and-video-editing) 16 | - [Internet](#internet) 17 | - [E-Mail](#e-mail) 18 | - [Audiovisual Communication](#audiovisual-communication) 19 | - [Chat Applications](#chat-applications) 20 | - [Torrent Client](#torrent-client) 21 | - [System Applications](#system-applications) 22 | 23 | 24 | 25 | 26 | # Tour of KDE Plasma Software ("I Need a Program That Does This") 27 | 28 | One of the core aims of the Korora Project is to provide an out-of-box Linux experience that can take care of the average's users daily needs with entirely free software. To save you the trouble of digging through every preinstalled application, we have compiled a list of the prepackaged applications within each version of Korora that fulfill a specific purpose. This will hopefully save you some trouble from immediately downloading more software when the right tool may already be installed. 29 | 30 | The KDE Plasma Desktop pulls its preloaded applications from [The KDE Project](https://www.kde.org/), the maintainers of KDE. Almost all KDE applications are developed in-house and **do not** pull in many GNOME apps, as some other distributions do. The KDE desktop has a sizable number of KDE and Qt libraries, and tends to favor applications that are optimized for use with those libraries. 31 | 32 | A handful of extra packages are added by Korora. 33 | 34 | 35 | ## Office Applications 36 | **PURPOSE**: I Need To Edit Some Documents 37 | - [LibreOffice Writer](https://www.libreoffice.org/discover/writer/) (Document Editor, like Microsoft Word) 38 | - [LibreOffice Calc](https://www.libreoffice.org/discover/calc/) (Spreadsheet editor, like Microsoft Excel) 39 | - [LibreOffice Draw](https://www.libreoffice.org/discover/draw/) (Image and flowchart editor, like Microsoft Visio) 40 | - [LibreOffice Impress](https://www.libreoffice.org/discover/impress/) (Presentation and slide editor, like Microsoft Powerpoint) 41 | - [Project Management](https://wiki.gnome.org/Apps/Planner) (plan projects) 42 | - [KJots](https://userbase.kde.org/KJots) (write short sticky-notes of information) (Under the name "Note Taker") 43 | - [KWrite](https://www.kde.org/applications/utilities/kwrite/) (Text Editor; supports syntax highlighting for code) 44 | 45 | 46 | ## Image Editor 47 | **PURPOSE**: I Need to Touch Up Some Photos 48 | - [KolourPaint](http://www.kolourpaint.org/) (A simple image editor in the vein of MS-Paint) 49 | - [GIMP](https://www.gimp.org/) 50 | - [Darktable](http://www.darktable.org/) (Photography and RAW photo developer) 51 | - [Inkscape](https://inkscape.org/) (Vector graphics editor) 52 | - [Cura LulzBot Edition](https://www.lulzbot.com/cura) (3D Printing software) 53 | 54 | 55 | ## Image Viewers 56 | **PURPOSE**: I Just Want to Look at Some Photos 57 | - [Gwenview](https://userbase.kde.org/Gwenview) (Under the name "KDE Image Viewer") 58 | - [digiKam](https://digikam.org/) (Photo Manger) (Under the name "Photo Management Program") 59 | - [showFoto](https://docs.kde.org/trunk5/en/extragear-graphics/showfoto/index.html) (Photo Manger/Editor) (Under the name "Photo Viewer and Editor") 60 | 61 | 62 | ## PDF Readers 63 | - [Okular](http://okular.kde.org) (Under the name "Document Viewer") 64 | 65 | 66 | ## E-Readers 67 | - [calibre](https://calibre-ebook.com/) (E-book reader) 68 | - [Okular](http://okular.kde.org) (Under the name "Document Viewer") 69 | 70 | 71 | ## RSS Reader 72 | - [Akregator](https://userbase.kde.org/Akregator) (Under the name "Feed Reader") 73 | - [KNode](https://www.kde.org/applications/internet/knode/) (Under the name "News Reader") 74 | 75 | 76 | ## Scanners 77 | **PURPOSE**: I Need to Scan a Document 78 | - [Skanlite](https://www.kde.org/applications/graphics/skanlite/) 79 | 80 | 81 | ## Screen Capture Tools 82 | **PURPOSE**: I Need to Take a Screenshot 83 | - [Spectacle](https://www.kde.org/applications/graphics/spectacle/) 84 | 85 | 86 | ## Multimedia Players 87 | **PURPOSE**: I Need to Play Some Music or Video 88 | - [VLC](http://www.videolan.org/) (Audio and Video player; supports most multimedia formats with no additional codecs) 89 | - [Amarok](http://amarok.kde.org) (Audio player) 90 | 91 | 92 | ## Multimedia Ripping and Conversion 93 | **PURPOSE**: I Need to Rip My CD or DVD 94 | - [K3b](http://www.k3b.org) (copies and burns CDs, DVDs, and Blu-rays) 95 | - [Handbrake](https://handbrake.fr) (Transcodes CDs, DVDs, and Blu-rays) 96 | - [KAudioCreator](http://kde-apps.org/content/show.php/KAudioCreator?content=107645) (rips audio CDs to your hard-drive) (Under the name "CD Ripper") 97 | - [soundKonvertor](https://github.com/dfaust/soundkonverter) (Converts audio files to other formats) 98 | 99 | 100 | ## Desktop Recording 101 | - [recordMyDesktop](https://sourceforge.net/projects/recordmydesktop/) 102 | 103 | 104 | ## Sound and Video Editing 105 | - [Audacity](http://www.audacityteam.org/) (audio editing program) 106 | - [Kdenlive](https://kdenlive.org/) (video editing program) 107 | 108 | 109 | ## Internet 110 | - [Firefox](https://www.mozilla.org/en-US/firefox/) 111 | - [Konqueror](http://konqueror.kde.org) (KDE Default browser; also doubles as a file manager) 112 | - [Qupzilla](https://www.qupzilla.com/) (A lightweight browser written with Qt) 113 | 114 | 115 | ## E-Mail 116 | - [KMail](https://www.kde.org/applications/internet/kmail/) (Under the name "Mail Client") 117 | 118 | 119 | ## Audiovisual Communication 120 | **PURPOSE**: I Need to Call / Video Conference With Someone 121 | - [Linphone](http://www.linphone.org) 122 | 123 | 124 | ## Chat Applications 125 | - [KDE Telepathy](https://userbase.kde.org/Telepathy) (Under the name "IM Contacts") 126 | - [Konversation](http://konversation.kde.org/) (IRC Client) 127 | 128 | 129 | ## Torrent Client 130 | - [KTorrent](https://www.kde.org/applications/internet/ktorrent/) 131 | 132 | 133 | ## System Applications 134 | - [KDE Partition Manager](https://www.kde.org/applications/system/kdepartitionmanager/) (Modify and delete system partitions) 135 | - [Back in Time](https://github.com/bit-team/backintime) (Create a backup of your system) 136 | - [ownCloud](https://owncloud.org/) (Self-hosted file sync and share platform) 137 | - [Storage Service Manager](https://github.com/KDE/pim-storage-service-manager) (Under the name "Cloud Storage Manager") 138 | - [Krfb](https://www.kde.org/applications/system/krfb/) (Under the name "KDE Desktop Sharing") 139 | - [KRDC](https://www.kde.org/applications/internet/krdc/) (Under the name "KDE Remote Desktop Client") 140 | -------------------------------------------------------------------------------- /GettingKorora/Installing-Korora.md: -------------------------------------------------------------------------------- 1 | 2 | 3 | **Table of Contents** 4 | 5 | - [Installing Korora](#installing-korora) 6 | - [Before you begin](#before-you-begin) 7 | - [Secure boot](#secure-boot) 8 | - [Fast shutdown](#fast-shutdown) 9 | - [INSTALLING KORORA AS A SOLE OS (SINGLE BOOT)](#installing-korora-as-a-sole-os-single-boot) 10 | - [Language](#language) 11 | - [Installation Summary](#installation-summary) 12 | - [Configuration](#configuration) 13 | - [INSTALLING KORORA AS MULTIPLE BOOT (DUAL BOOT)](#installing-korora-as-multiple-boot-dual-boot) 14 | 15 | 16 | 17 | 18 | # Installing Korora 19 | 20 | Being a Fedora Remix, Korora inherits the [Anaconda](https://fedoraproject.org/wiki/Anaconda) installer for all of our images. Having undergone a massive re-write in 2012 it has seen solid improvements since then. This document walks you through the installation of Korora onto your hard disk. We try to cover common scenarios, including EFI as it is becoming more common these days. 21 | 22 | 23 | ## Before you begin 24 | 25 | > It's always a good idea to backup any important data before installing any operating system and Korora is no different. 26 | 27 | Korora is able to dualboot Windows, however if you are using Windows 8 or later versions, there are some things you should do before installing Korora. 28 | 29 | 30 | ## Secure boot 31 | 32 | Secure boot is _not_ an integral part of EFI, although it should work on Korora you may wish to turn it off. You do this by entering your computer's EFI setup and look for a way to disable it. Unfortunately how you enter the EFI is different with every brand of computer, as is the menu location for disabling Secure Boot. 33 | 34 | 35 | ## Fast shutdown 36 | 37 | Windows 8 implements a fast shutdown feature that helps speed up shutdown and startup operations on a single-boot computer. Unfortunately, this feature can cause filesystem corruption if it's used on a multi-boot computer. You can disable the feature under Windows by launching an Administrator Command Prompt and typing: 38 | 39 | ``` 40 | powercfg /h off 41 | ``` 42 | 43 | So let's recap: You've gone to the Korora Download page here: 44 | 45 | [https://kororaproject.org/download](https://kororaproject.org/download) 46 | 47 | You chose a version of Korora, along with the desktop environment of your choice. Then you've installed the ISO file on a USB stick -- the preferred method of trying out Korora (though you can still burn a DVD and install that way, if need be) -- by using the instructions on the Creating Bootable Media page here: 48 | 49 | [https://kororaproject.org/support/documentation/creating-bootable-media](https://github.com/kororaproject/kp-documentation/wiki/Creating-Bootable-Media) 50 | 51 | Now you're ready to go. 52 | 53 | **BUT BEFORE YOU START**, an important note: Installing Korora on your hard drive will delete any currently existing data. **If you wish to keep the data that is currently on the drive before installing Korora, back it up first before performing the Korora installation**. 54 | 55 | Let me repeat that: If you have data on the hard drive on which you are about to install Korora, installing Korora will wipe out any data you currently have on that particular drive. So if you want to save some/all of the data on your drive, back it up first. 56 | 57 | 58 | ## INSTALLING KORORA AS A SOLE OS (SINGLE BOOT) 59 | 60 | Insert your Live USB drive into your computer and boot (or reboot, if it is already running). Once you are up and running, you will get the desktop screen of your desktop of choice which should automatically have a Korora Welcome window appear in the centre. This window is just a "thank you," along with some buttons which take you to various locations in the Korora infrastructure. 61 | 62 | The install program is Anaconda, which is the Fedora Project's installer. Anaconda is a fairly sophisticated installer. It supports installation from local and remote sources such as CDs and DVDs, images stored on a hard drive, NFS, HTTP, and FTP. For more information on Anaconda, visit the Fedora Project's Anaconda page here: 63 | 64 | [https://fedoraproject.org/wiki/Anaconda](https://fedoraproject.org/wiki/Anaconda) 65 | 66 | So if you click on the icon on the desktop that says "Install to Hard Drive," or click on "Install Korora" from the Korora Welcome window, Anaconda will start. Anaconda will take you through the installation process with the following screens: 67 | 68 | 69 | ### Language 70 | 71 | Here you will chose the language with which you will use the new software. Click on Continue in the lower right to go to the next screen, which is 72 | 73 | 74 | ### Installation Summary 75 | 76 | Here you will set your Date/Time by the time zone in which you live, set your keyboard preference in Keyboard, set the destination for your installation (your hard drive) in Installation Destination, and set your Network Configuration (note: you need not be connected to install, but it doesn't hurt to be connected during the installation process. The Network Configuration allows you to connect to your network during the install). 77 | 78 | Chances are you will get a message under Installation Destination saying "No disks selected" and/or an error message at the bottom in a yellow stripe saying, "Please complete items marked with the icon before continuing to the next step." No need to worry. Go to the item where the icon is and remedy the problem. 79 | 80 | For example, if it is under Installation Destination, click on the icon of the hard drive on which you want to install Korora, and then click Done in the upper left. You will get a window telling you how much free space is available/unavailable and and it will bring you to a screen where you can choose the drive on which you wish to install Korora. When you choose your drive, you will get a second window notifying you of your drive's available space, as well as allowing you to choose your partition scheme and a check box to encrypt your data. Using the row of buttons on the bottom, you can also Cancel, Custom Partition and Reclaim Space. 81 | 82 | If you are installing on a disk which already has a Linux distro or other operating system on it, you are more than likely going to have to reclaim space using the Reclaim Space feature. Click on the Reclaim Space button in the lower right and this will take you to your current disk mapping. To do a "clean install" of Korora -- wiping the drive and giving Korora a fresh start (and, again, you have backed up the data you want to keep, right?) -- click on the hard disk on the top line and click delete. This will free up the space necessary to install Korora. 83 | 84 | Once you do this, you will return to the Installation Summary window and your System field will no longer have the warning icon. If you're ready to install, you can click the Begin Installation button in the lower right corner. 85 | 86 | 87 | ### Configuration 88 | 89 | While the software is installing on your hard drive, you can set your Root Password and create your User Account. 90 | 91 | Click on the Root Password to create a Root Password for your system. This will be used when updating software and other situations where the root password is required. Once you've completed this step by clicking Done in the upper left, you will be returned to the original screen where you can create a User Account. 92 | 93 | To create a User Account, click on the User Account to put in your name, your login and a password for this particular account. Once you have completed this step, click Done in the upper left to return to the original screen for creating Root Password and a User Account. 94 | 95 | At this point, the installation should be continuing along, with the progress measured in a bar at the bottom of the page. Once the bar is completely blue, you will get a message saying "Korora is now successfully installed on your system and ready for you to use! When you are ready, reboot your system to start using it!" If you're ready, click on the Done button in the lower right, which will bring you back to your desktop. 96 | 97 | From your desktop, you can reboot and start using Korora. 98 | 99 | 100 | ## INSTALLING KORORA AS MULTIPLE BOOT (DUAL BOOT) 101 | 102 | There have been reports that scripts such as Easy2boot and Grub4dos conflict with the Grub setup created by Anaconda so their use cannot be recommended. 103 | 104 | [To follow] 105 | --------------------------------------------------------------------------------