Q4OS Frequently asked questions, user manual, rev. 07/2021
user manual
1. IntroductionNotify us about any errors you find, suggestions are appreciated. When possible send us what you think would be a clearer solution. You can safely stick to Trinity desktop environment FAQ.
The easiest way in Linux is to plug your usb in, do not mount it, and run in terminal:
$ sudo cp bootable.iso /dev/sdx
'sdx' is the target usb drive, for example 'sdb'
'bootable.iso' is bootable Q4OS installation CD image, you can download it from Q4OS website.
Alternatively, you can use multiplatform 'UNetbootin' or 'Rufus' software to create bootable USB disks, see how to create a live media.
Sure, the preferred way is to proceed installation from 'Live' CD, as it gives you bootloader install option. If you let installer to install Grub bootloader, it will autodetect available operating systems including Windows and offer them all on every boot. If you want to keep Windows bootloader, don't forget to uncheck the related checkbox during installation.
We strongly recommend to backup all your data before, please read installation instructions.
We recommend you to install the PulseAudio sound server first:
$ sudo apt install pulseaudio pavucontrol-qt
Reboot your computer. Right-click to 'mixer' icon in system tray -> 'Select Master Channel...' -> set 'Current Mixer' to 'PulseAudio' in the top right listbox -> click 'Ok' to close the dialog. Run 'Volume Control' application from the Start menu and configure output mixer settings on the 'Output Devices' tab, check if output channels are not muted. The audio system should work now. If not so, continue following the steps below.
Left-click to 'mixer' icon in the system tray, and click to 'Mixer' button to check and update audio mixer levels. Make sure there is the 'PulseAudio' sound card selected in the top right corner of the 'kmix' mixer window. Then run command in terminal and check debug output:
$ artsplay /opt/trinity/share/sounds/KDE_Startup.wav
If there is still no sound, terminate temporarily Trinity sound server and try to play audio with independent alsa player:
$ artsshell terminate $ aplay /opt/trinity/share/sounds/KDE_Startup.wav
Again, check debug output. If your audio system still doesn't work, continue Troubleshooting sound problems at Trinity FAQ.
We have a handy tool to autofix broken dependencies in Q4OS, just run in terminal:
$ sudo sh /usr/share/apps/q4os_system/bin/qapt_fix.sh $ sudo apt update $ sudo apt dist-upgrade
Keep in mind, we strongly recommend to install software from reliable and Debian compatible sources only to prevent package system from being corrupted.
A common glitch, that occurs on Netbooks with a small keyboard. Keyboard is blocked by NumLock, you could try to switch NumLock off. Launch Control Panel:
Control Panel -> Peripherals -> Keyboard -> NumLock on KDE startup -> set Off
Login again and try the keyboard.
Yes, Q4OS can scale the screen resolution, please read screen resolution chapter.
Run 'ksensors' application from Start menu -> Programs -> Accessories -> System -> KSensors. If 'ksensors' is not installed yet, follow the hardware sensors chapter to install it. Click with the right mouse button to 'ksensors' icon in system tray -> Configure -> select related HW sensors group -> select desired sensor from the list -> Dock tab -> check 'Visible' checkbox. You can optionally set colors, alarms, thresholds, actions on limits exceeding and other options. Click 'Apply' button and close the dialog.
You need to set system wide environment variables. Open the /etc/environment file with your favorite editor. Add the following lines, modifying appropriately, you must duplicate in both upper-case and lower-case because some programs only look for one or the other:
http_proxy="http://myproxy.server.com:8080/" https_proxy="http://myproxy.server.com:8080/" ftp_proxy="http://myproxy.server.com:8080/" no_proxy="localhost,127.0.0.1,localaddress,.localdomain.com" HTTP_PROXY="http://myproxy.server.com:8080/" HTTPS_PROXY="http://myproxy.server.com:8080/" FTP_PROXY="http://myproxy.server.com:8080/" NO_PROXY="localhost,127.0.0.1,localaddress,.localdomain.com"
APT package management system will not obey the environment variables when used normally with sudo. So separately configure them; create a file called 95proxies in /etc/apt/apt.conf.d/, and include the following:
Acquire::http::proxy "http://myproxy.server.com:8080/"; Acquire::ftp::proxy "ftp://myproxy.server.com:8080/"; Acquire::https::proxy "https://myproxy.server.com:8080/";
Finally, reboot to make sure the changes take effect.
We recommend to use reliable and deeply proven default Q4OS/Debian kernel, there isn't too much reasons for ordinary users to use newer kernel. Keep in mind, the latest kernels are not so secure as the rock stable and exhaustively tested default Debian kernel, however it could bring improvements and newer device drivers and support. If you prefer for some reasons the latest linux kernel, run the auto-installation script in terminal to easily install it from backports repository:
$ qinst-kernel-bpo
The old good default kernel will not be uninstalled, so you can anytime choose and boot it from the grub boot menu, if you will fall into any issues.
1) Launch the Control Panel and go to Desktop -> Multiple Desktops and select how many virtual desktops you wish to have. You can then set up a couple ways of switching desktops:
2a) Add a desktop switch applet to your taskbar by right-mouse clicking on the taskbar and select Add Applet to Panel. If the taskbar is locked, un-lock it first, then choose the Add Applet to Panel option.
2b) In the pop-up window that appears, select the Desktop Pager / Switcher app, then click the Add To Panel button.
3a) Configure a keyboard shortcut by launching the Control Panel and go to Regional & Accessibility -> Keyboard Shotcuts.
3b) Under the Global Shortcuts tab, scroll down the list of commands and find Switch To Next Desktop under the Desktop Switching heading.
3c) Click the button next to the Custom option and assign the keyboard combination you wish to use to switch your desktops.
3d) Click the OK button to save.
There could be three logical types of icons present on your desktop. System and global icons owned by root and User icons, created and owned by user. Users are not allowed to directly edit or rename system and global icons, however they can remove them from the desktop if needed.
The given set of System icons, 'My Computer', 'My Documents', 'My Network Places', 'Trash', 'Web Browser' and 'Printers', is not directly editable by a user, however users are allowed to remove them from their own desktop.
Global icons are usually created by application installers, they are owned by root and shared by all users. Users can hide the global icons from the desktop, but they are not allowed to edit or rename such icon.
User icons and shortcuts are created by a single user and users have full control over them. You can freely delete and rename it, as well as edit icon properties.
If you would want to edit global or system icon, we recommend to remove it from the desktop and create matching user's icon using Drag&drop -> Copy from the Start menu. It will be owned by user and fully editable as usual, use Right mouse click -> Properties.
Open the Start menu, click with the right mouse button on any item under the 'Programs' entry, select 'Edit menu', menueditor window appears. You will be able to create new custom submenus/folders structure and fill it with desired menu items. You can create new shortcuts using right mouse click, or drag&drop icons from the Start menu or Desktop into the menueditor window. Newly created items will appear in the Start menu after closing the menueditor window.
In addition, you can switch Start menu items to be organized by Categories or by Applications:
$ sh /usr/share/apps/q4os_system/bin/kmenu_struct.sh --help
Yes, edit file '$HOME/.trinity/share/config/kickerrc' in your home directory. There are several configuration options beginning 'Bourbon' commented out by default. You need to uncomment 'BourbonSysViewCustomItems' line and specify '.desktop' links you wish to be displayed on the right menu panel, use comma ',' as a delimiter. It's also possible to hide default shortcuts with the 'BourbonShowSysViewFolders=false' and 'BourbonShowSysViewApps=false' options.
Run command to update Welcome screen shortcut in terminal:
$ sudo kwriteconfig --file '/usr/share/applications/q4os-welcome-screen.desktop' --group 'Desktop Entry' --key 'NoDisplay' 'false'
Alternatively, you can edit '/usr/share/applications/q4os-welcome-screen.desktop' file manually. Welcome screen icon will appear under Start menu -> Programs -> Accessories -> System folder.
You need to add an application shortcut, i.e. the '.desktop' file, into the '$HOME/.trinity/Autostart' or '$HOME/.q4data/Programs/Startup' autostart folder. It will be launched immediately after the user login. Just drag any of application shortcuts from the start menu or from desktop and drop it into the autostart folder. It's also possible to place a shell script or executable into the autostart folder as well.
Simply run in terminal:
$ sh /usr/share/apps/q4os_system/bin/default_desktop_settings.sh
Icon activation by mouse doubleclicking is default in Q4OS. It's easy to set single click activation, hover effect and more in Control Panel:
Control Panel -> Peripherals -> Mouse -> General tab -> Single click to open files and folders
You can do this without any other packages, simply press 'PrtScr' key and then right click on the desktop and select Paste clipboard contents, this will display a dialog where you can enter the filename and image type and the file will be saved to the desktop. You could also open konqueror to browse to preferred folder, again right click and select Paste clipboard contents and file will be saved to preferred location.
In addition, there is a lightweight and powerful application 'ksnapshot-trinity', it's capable to grab full screen, region, a window or window part only. You can install it from terminal this way:
$ sudo apt install ksnapshot-trinity
Yes, you have to unlock advanced Control Panel options in terminal:
$ sudo kcmodules --unlock
Go to Control Panel -> Appearance & Themes -> Icons, and setup theme you prefer.
You only need to enable khotkeys service to be ran on session login. Go to Control Panel:
Control Panel -> Regional & Accessibility -> Input Actions -> General Settings tab -> uncheck Disable KHotKeys checkbox
It happens rarely on some specifically configured systems. The workaround, that should fix it, is to re-switch from classic - kicker - classic menu. You could report it as a new bug in our Bug tracker, and add some description if you will find any connections.
Keyboard switching shortcut defaults to 'Alt+Space' or 'Ctrl+Alt+K'. It works flawlessly, if you have installed latin keyboard layouts only. To be able to switch non-latin keyboard freely, you need to add 'latin layout' to each keyboard layout you use. Run Control Panel:
Control Panel -> Regional & Accessibility -> Keyboard layout -> select a non-latin keyboard layout ->
-> check 'Include latin layout' checkbox
Simply hover your mouse over the "tdepowersave" icon in the system tray, and use mouse scroll wheel to adjust brightness up or down. If the icon is not available in the system tray, you need to install "tdepowersave-trinity" package and login to the Trinity desktop session again.
Alternatively, you can install "klcddimmer-trinity" package and add applet in the system panel, however you will need to configure it to use a brightness control backend, for example "xbacklight".
You have to have Q4OS/Trinity desktop effects enabled, it can be setup via Welcome screen or Control Panel. Edit the '/etc/conky/conky.conf' file and add lines:
own_window yes own_window_hints undecorated,below,sticky,skip_taskbar,skip_pager own_window_argb_visual own_window_argb_value 0
Comment out line:
#own_window_type desktop
Q4OS Frequently asked questions, user manual, rev. 07/2021