Merge branch 'master' of github:/tiyn/wiki

wiki/android.md

@@ -4,6 +4,23 @@
 [Linux](/wiki/linux.md) kernel.
 It is designed primarily for mobile devices with touch screens like tablets or smart phones.
 
+## Managing the Data
+
+The data and files stored on Android
+[smart devices](/wiki/smart_devices.md#smartphones-and-tablet-computers) are sometimes needed on
+computers.
+
+For [Windows](/wiki/windows.md) this can easily be achieved by connecting it via USB.
+No further software is needed as the device manager handles the phone correctly most of the times.
+
+For [Linux-based systems](/wiki/linux.md) the
+[device](/wiki/smart_devices.md#smartphones-and-tablet-computers) also has to be connected to the
+computer.
+But in this case also a software is needed to [mount it](/wiki/linux/disk-management.md#mounting),
+this software/program is called [android-file-transfer](/wiki/linux/android-file-transfer.md).
+For further information and a guide on how to mount a Android device correctly navigate to the
+[corresponding section](/wiki/linux/android-file-transfer.md#mounting-and-unmounting-android-device).
+
 ## App Store
 
 The most used app store of android is the [Google Play Store](https://play.google.com/).

wiki/audio.md

@@ -10,8 +10,9 @@ Podcasts need a so called Podcatcher.
 A Podcatcher is used to subscribe to podcasts and download them automatically.
 For Linux specific music software navigate to the corresponding
 [wiki entry](/wiki/linux/audio.md).
-For voice based communication navigate to the [communication article](/wiki/communication.md) and
-the corresponding [VoIP section](/wiki/communication.md#voip).
+For voice based communication, social platforms or messengers navigate to the
+[communication article](/wiki/communication.md) and the corresponding
+[section](/wiki/communication.md#social-platforms-messengers-and-voip-services).
 For headphones navigate to the [headphones article](/wiki/headphones.md):
 
 ## Technical Specifications

wiki/communication.md

@@ -4,12 +4,14 @@ Computer communication can have multiple different forms.
 There are voice and video calls aswell as text based messaging.
 This article bundles all of them.
 
-## VoIP
+## Social Platforms, Messengers and VoIP Services
 
-This section lists some of the most common Voice over IP (VoIP) platforms.
+This section lists some of the most common Voice over IP (VoIP) services, messengers and other
+social platforms.
 
-- [Matrix](/wiki/matrix.md) is a decentralized and open-source social platform.
 - [Discord](/wiki/discord.md) is a widely used, proprietary social platform.
+- [Matrix](/wiki/matrix.md) is a decentralized and open-source social platform.
+- [Signal](/wiki/signal.md) is an open-source, encrypted messaging service.
 
 ### Soundboards
 

wiki/linux/android-file-transfer.md

@@ -0,0 +1,28 @@
+# android-file-transfer
+
+[android-file-transfer](https://github.com/whoozle/android-file-transfer-linux) is an MTP client
+that allows accessing the files of an [Android](/wiki/android.md)
+[smart device](/wiki/smart_devices.md#smartphones-and-tablet-computers) under
+[Linux](/wiki/linux.md).
+
+## Setup
+
+On most linux distributions Khal can be installed with the `android-file-transfer` package.
+Alternatively it can be installed via
+[GitHub](https://github.com/whoozle/android-file-transfer-linux).
+ 
+## Usage
+
+This section addresses the usage of android-file-transfer.
+
+### Mounting and Unmounting Android Device
+
+An [Android](/wiki/android.md)
+[smart device](/wiki/smart_devices.md#smartphones-and-tablet-computers) can be mounted by using the
+following command.
+Please note that this command assumes one Android device is connected via USB.
+In this case the device will be mounted on the directory `~/mnt`.
+
+```sh 
+aft-mtp-mount ~/mnt
+```

wiki/linux/gtk.md

@@ -0,0 +1,46 @@
+# GTK
+
+[GTK](https://gtk.org) is an GUI and widget toolkit.
+
+## Setup
+
+On most linux distributions different GTK versions are installed as a dependency of various
+programs that use graphical user interfaces.
+
+### Configurations
+
+GTK has different versions.
+For GTK3 and GTK4 configurations can be achieved by creating the file `settings.ini` in the folders
+`~/.config/gtk-3.0` and `~/.config/gtk-4.0`.
+An example file that enables dark mode, uses the Adwaita theme and sets the default font to
+sans-serif of size 12 looks something like the following.
+
+```txt 
+[Settings]
+gtk-application-prefer-dark-theme = true
+gtk-icon-theme-name = Adwaita
+gtk-font-name = Sans 12
+```
+
+For GTK2 an older version of config files has to be used.
+The file can be found or created at `~/.config/gtk-2.0/gtkrc-2.0`.
+A similar setup to the previous configuration of GTK3 and GTK4 can be achieved by the following.
+
+```txt 
+gtk-theme-name="AdwaitaDark"
+gtk-font-name="Sans 12"
+```
+
+#### Achieving a System-Wide Uniform Look
+
+[Qt](/wiki/linux/qt.md) is the other big widget toolkit in use.
+An easy way to achieve a uniform look of GTK and Qt is the usage of the Adwaita theme in both
+toolkits.
+This is also described in the
+[official Arch wiki](https://wiki.archlinux.org/title/Uniform_look_for_Qt_and_GTK_applications#Styles_for_both_Qt_and_GTK).
+
+Since it is the default theme on GTK it just has to be set inside as described in the 
+[configuration section](#configuration).
+
+For setting the same theme for Qt refer to the
+[corresponding entry](/wiki/linux/qt.md#achieving-a-system-wide-uniform-look).

wiki/linux/lightdm.md

@@ -8,9 +8,9 @@ It is available for both [X](/wiki/linux/x_window_system.md) and Wayland.
 
 On most linux distributions LightDM can be installed with the `lightdm` package.
 Additionally `lightdm-gtk-greeter` and `xorg-server-xephyr` are recommended.
-This setup will work with [LightDM-GTK-Greeter](#lightdm-gtk-greeter) which is the default 
-[greeter](#greeters) but others may be chosen.
-If that is the case `lightdm-gtk-greeter` does not have to be installed, but another one.
+This setup will work with [LightDM-GTK-Greeter](#lightdm-gtk-greeter) which is the default greeter. 
+If another greeter is to be chosen `lightdm-gtk-greeter` does not have to be installed, but an
+alternative for it.
 For a guide on how to set the greeter navigate to the [greeter section](#greeters).
 This section will also discuss various other greeters like the
 [LightDM-Mini-Greeter](#lightdm-mini-greeter).
@@ -67,6 +67,7 @@ If no `greeter-session` is set the default will fall back to the
 
 The [LightDM-GTK-Greeter](https://github.com/Xubuntu/lightdm-gtk-greeter) is the default greeter 
 for LightDM.
+This is the default [greeter](#greeters) of [GTK](/wiki/linux/gtk.md) but others may be chosen.
 
 ### LightDM-Mini-Greeter
 

wiki/linux/package_manager.md

@@ -19,6 +19,19 @@ It features the same syntax.
 
 This section addresses various usages of the arch linux package managers.
 
+### Downgrading Packages 
+
+Packages of the AUR can be downgraded by using the
+[Downgrade](https://github.com/archlinux-downgrade/downgrade) program.
+This program can then easily be used to an AUR package.
+This works like the following assuming the package `v4l2loopback-dmks` needs to be downgraded.
+
+```sh 
+sudo downgrade v4l2loopback-dmks
+```
+
+Afterwards the target version can be selected and the downgrading process will conclude.
+
 #### Manual Installation of a `PKGBUILD` File
 
 A `PKGBUILD` file is a [shell](/wiki/linux/shell.md) script that contains the installation 

wiki/linux/qt.md

@@ -25,3 +25,22 @@ To make this config apply for all Qt applications the following line needs to be
 ```sh
 export QT_QPA_PLATFORMTHEME="qt6ct"
 ```
+
+Afterwards `qt6ct` can be used to enable the dark mode or change other configurations.
+
+#### Achieving a System-Wide Uniform Look
+
+[GTK](/wiki/linux/gtk.md) is the other big widget toolkit in use.
+An easy way to achieve a uniform look of GTK and Qt is the usage of the Adwaita theme in both
+toolkits.
+This is also described in the 
+[official Arch wiki](https://wiki.archlinux.org/title/Uniform_look_for_Qt_and_GTK_applications#Styles_for_both_Qt_and_GTK).
+
+A simple way to achieve this in Qt is the installation of
+[adwaita-qt6](https://github.com/FedoraQt/adwaita-qt) which is also available as an
+[AUR](/wiki/linux/package_manager.md#installing-an-aur-program-with-a-specific-version) package.
+After the installation it can be selected by `qt6ct` as described in the
+[configuration section](#configuration).
+
+For setting the same theme for GTK refer to the
+[corresponding entry](/wiki/linux/gtk.md#achieving-a-system-wide-uniform-look).

wiki/linux/v4l2.md

@@ -21,6 +21,11 @@ package needs to be installed.
 Some distributions have a package named `v4l2loopback-dkms` in the package
 manager, making the manual installation process unnecessary.
 
+Make sure to
+[start the service](/wiki/linux/systemd.md#startstopenabledisable-a-service) by
+running `systemctl start v4l2loopback.service` and/or enable it to start after each
+boot with `systemctl enable v4l2loopback.service`.
+
 ### Usage
 
 This section focusses on various use-cases for the v4l2loopback software.
@@ -75,3 +80,18 @@ Afterwards enable the service to start at every boot process by running:
 ```sh
 sudo systemctl enable v4l2loopback
 ```
+
+## Troubleshooting
+
+This section focusses on various errors that can appear in the v4l2loopback software.
+
+### `Failed to start streaming on '/dev/video2' (Invalid argument)`
+
+This error does occur most of the time when trying to start
+[OBS' virtual camera](/wiki/obs.md#virtual-camera).
+This section is based on an
+[OBS Forum entry by rebelduck](https://obsproject.com/forum/threads/obs-virtual-camera-failed-to-start-streaming-on-dev-video2-invalid-argument.184717/)
+To fix it downgrade the packages `v4l2loopback-dkms` and `v4l2loopback-utils` to the last working
+version.
+For [Arch Linux](/wiki/linux/arch-linux.md) this can be achieved by using
+[Downgrade](/wiki/linux/package_manager.md#downgrading-packages).

wiki/obs.md

@@ -20,10 +20,6 @@ camera.
 First of all [V4L2](./linux/v4l2.md) needs to be set up.
 This guide assumes it is set up according to the section in the
 [V4L2 entry](./linux/v4l2.md#v4l2loopback).
-Make sure to
-[start the service](/wiki/linux/systemd.md#startstopenabledisable-a-service) by
-running `systemctl start v4l2loopback.service` or enable it to start after each
-boot with `systemctl enable v4l2loopback.service`.
 Afterwards the virtual camera can be started.
 
 ### Background Removal
@@ -39,3 +35,16 @@ describes various possibilities to install the background removal for OBS on
 different systems.
 On Linux systems background removal is often contained in a package named
 `obs-backgroundremoval` or similarly.
+
+## Troubleshooting
+
+This section focusses on various errors that can appear by using OBS.
+
+### `Output Failed: If you are using NVENC or AMD encoders, make sure the video drivers are up to date`
+
+This error does occur most of the time when trying to start
+[OBS' virtual camera](/wiki/obs.md#virtual-camera).
+If all the drivers are up to date there is a chance that it is caused by a bug or error in the code
+of [V4L2](/wiki/linux/v4l2.md).
+A possible fix is described in a 
+[corresponding section of the V4L2 entry](/wiki/linux/v4l2.md#failed-to-start-streaming-on-devvideo2-invalid-argument).

wiki/signal.md

@@ -0,0 +1,21 @@
+# Signal
+
+[Signal](https://signal.org) is an encrypted, open-source messenger that allows voice and video
+calls as well as instant messaging chats.
+
+## Usage
+
+This section addresses various features of Signal.
+
+### Clients and Utilities
+
+The following is a list of clients and other utilities that can be used to communicate via Signal, 
+export or backup messages.
+
+- [Signal App](https://signal.org/download) is a mobile application available for
+  [Android](/wiki/android.md) or iOS.
+- [Signal Desktop](https://signal.org/download) is a desktop application available for
+  [Windows](/wiki/windows.md), various [Linux distributions](/wiki/linux.md#distributions) and 
+  MacOS.
+- [sigtop](https://github.com/tbvdm/sigtop) is a utility that allows exporting messages and
+  attachments by communicating with a Signal Desktop instance on the same device.