diff --git a/wiki/android.md b/wiki/android.md index 6538698..592b456 100644 --- a/wiki/android.md +++ b/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/). diff --git a/wiki/audio.md b/wiki/audio.md index 7f749d8..ea7a024 100644 --- a/wiki/audio.md +++ b/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 diff --git a/wiki/communication.md b/wiki/communication.md index c0e64a9..6acda1c 100644 --- a/wiki/communication.md +++ b/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 diff --git a/wiki/linux/android-file-transfer.md b/wiki/linux/android-file-transfer.md new file mode 100644 index 0000000..5d28be1 --- /dev/null +++ b/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 +``` diff --git a/wiki/linux/gtk.md b/wiki/linux/gtk.md new file mode 100644 index 0000000..ae5d132 --- /dev/null +++ b/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). diff --git a/wiki/linux/lightdm.md b/wiki/linux/lightdm.md index eee37cf..ca4b779 100644 --- a/wiki/linux/lightdm.md +++ b/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 diff --git a/wiki/linux/package_manager.md b/wiki/linux/package_manager.md index f4f19d5..4c3142f 100644 --- a/wiki/linux/package_manager.md +++ b/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 diff --git a/wiki/linux/qt.md b/wiki/linux/qt.md index dac1dca..ef22f3e 100644 --- a/wiki/linux/qt.md +++ b/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). diff --git a/wiki/linux/v4l2.md b/wiki/linux/v4l2.md index 9d80019..aab788b 100644 --- a/wiki/linux/v4l2.md +++ b/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). diff --git a/wiki/obs.md b/wiki/obs.md index b61ca77..a436e34 100644 --- a/wiki/obs.md +++ b/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). diff --git a/wiki/signal.md b/wiki/signal.md new file mode 100644 index 0000000..5f74a45 --- /dev/null +++ b/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.