Skip to content

Commit d13349a

Browse files
committed
Update README
Split out FreeBSD notes
1 parent 2e4adca commit d13349a

2 files changed

Lines changed: 43 additions & 40 deletions

File tree

README-FreeBSD.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
FreeBSD
2+
========
3+
4+
## Initial considerations
5+
6+
Please make sure that you add your user to the webcamd group after the installation of the dependencies, this can be done by running `doas pw groupmod webcamd -m $USER`
7+
8+
You will also want to enable webcamd and the cuse module to load at boot for that you'll need to modify __/etc/rc.conf__ and __/boot/loader.conf__ with:
9+
10+
>webcamd_enable="YES"
11+
12+
and
13+
14+
>cuse_load="YES"
15+
16+
respectively.
17+
18+
## Getting all the necessary dependencies
19+
20+
Run `doas pkg install gmake gcc pkgconf libjpeg-turbo usbmuxd libusbmuxd alsa-lib v4l_compat speex ffmpeg webcamd libappindicator`
21+
22+
## Building and Installing
23+
24+
Run `gmake`, or `gmake droidcam-cli` if you wish to only build the command line version of droidcam.
25+
26+
To install, run `doas ./install-client`
27+
28+
## Running
29+
30+
You'll need to run `doas webcamd -B -c v4l2loopback` before launching droidcam

README.md

Lines changed: 13 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
Linux
22
========
33

4+
This is the original Linux client for classic version of DroidCam, available at [dev47apps.com](https://dev47apps.com).
5+
46
## Download and Install
57

68
You can download and install the latest release from the official website at https://www.dev47apps.com/droidcam/linux/, along with instructions on how to update the webcam resolution and other info.
@@ -33,7 +35,7 @@ Run `make`, or `make droidcam-cli` if you skipped installing GTK+, to build the
3335
To install, run `sudo ./install-client`
3436

3537

36-
Note: Some distros are removing libappindicator in their latest versions (Ubuntu 21+, Fedora 33+, Debian Bullseye+), used for system tray icon.
38+
Upd: Some distros are removing libappindicator in their latest versions (Ubuntu 21+, Fedora 33+, Debian Bullseye+), used for system tray icon.
3739
The new dependency (Ubuntu) is `libayatana-appindicator3-dev`
3840

3941
You can specify the indicator libary to make like so:
@@ -43,19 +45,22 @@ You can specify the indicator libary to make like so:
4345
## V4L2 Loopback (Webcam driver)
4446

4547
DroidCam has its own version of v4l2loopback, `v4l2loopback-dc`, which makes the app a little more user-friendly.
46-
DroidCam works with the standard v4l2loopback module, so installing `v4l2loopback-dc` is optional.
4748

48-
The standard v4l2loopback module is already available on most distros as v4l2loopback-dkms. See [v4l2loopback usage examples](https://github.com/dev47apps/droidcam/releases/tag/v1.7).
49+
DroidCam also works with the standard [v4l2loopback module](https://wiki.archlinux.org/title/V4l2loopback), so installing `v4l2loopback-dc` is optional.
50+
The standard v4l2loopback module is readily available on most distros as `v4l2loopback-dkms`. See [v4l2loopback usage examples](https://github.com/dev47apps/droidcam/releases/tag/v1.7).
4951

5052
The main differences with `v4l2loopback-dc` are that:
51-
* Youll see "DroidCam" in the list of webcams.
53+
* You'll see "DroidCam" in the list of webcams.
5254
* It works with Skype+Chrome without the need for `exclusive_caps=1`.
5355
* The install scripts will configure v4l2loopback-dc to auto-load after reboot.
5456

55-
To use v4l2loopback-dc, make sure you have these dependencies installed
57+
If you wish to use v4l2loopback-dc, first install these dependencies
5658
```
57-
linux-headers-`uname -r` gcc make
59+
linux-headers-`uname -r`
60+
gcc
61+
make
5862
```
63+
5964
then run `sudo ./install-video` to build the module and install it.
6065

6166
Debian/Ubuntu and RHEL (Fedora/SUSE) based distros:
@@ -66,8 +71,8 @@ Debian/Ubuntu and RHEL (Fedora/SUSE) based distros:
6671
## Sound
6772

6873
DroidCam can use the Linux ALSA Loopback sound card for audio.
69-
There are many differences and quirks with audio on different Linux systems.
70-
It’s recommended you use a regular microphone and keep droidcam for video only.
74+
There are many differences and nuances with audio on different Linux systems.
75+
It's highly recommended you use a regular microphone and keep droidcam for video only.
7176

7277
Run `sudo ./install-sound` to load the Linux ALSA Loopback sound card which the Droidcam client will use for audio input.
7378

@@ -84,35 +89,3 @@ To use DroidCam with Pipewire ([Source](https://gitlab.freedesktop.org/pipewire/
8489
* Go to the Input Devices tab
8590
* Check which VU meter reacts to the phone's audio input (eg. Built-in Audio Pro 1), this is the desired audio input device.
8691
* Inside pavucontrol you can now set this device as default input or choose it as the input device for individual apps etc.
87-
88-
89-
FreeBSD
90-
========
91-
92-
## Initial considerations
93-
94-
Please make sure that you add your user to the webcamd group after the installation of the dependencies, this can be done by running `doas pw groupmod webcamd -m $USER`
95-
96-
You will also want to enable webcamd and the cuse module to load at boot for that you'll need to modify __/etc/rc.conf__ and __/boot/loader.conf__ with:
97-
98-
>webcamd_enable="YES"
99-
100-
and
101-
102-
>cuse_load="YES"
103-
104-
respectively.
105-
106-
## Getting all the necessary dependencies
107-
108-
Run `doas pkg install gmake gcc pkgconf libjpeg-turbo usbmuxd libusbmuxd alsa-lib v4l_compat speex ffmpeg webcamd libappindicator`
109-
110-
## Building and Installing
111-
112-
Run `gmake`, or `gmake droidcam-cli` if you wish to only build the command line version of droidcam.
113-
114-
To install, run `doas ./install-client`
115-
116-
## Running
117-
118-
You'll need to run `doas webcamd -B -c v4l2loopback` before launching droidcam

0 commit comments

Comments
 (0)