Skip to content

Commit

Permalink
Merge pull request #15 from alba4k/main
Browse files Browse the repository at this point in the history
minor improvements to README.md
  • Loading branch information
stefanpartheym authored Mar 2, 2023
2 parents ff3615e + 85e390c commit 4d33274
Show file tree
Hide file tree
Showing 2 changed files with 21 additions and 8 deletions.
27 changes: 20 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,8 @@ Please follow the steps below to upgrade:

## Upgrading to `v1.1.0`

In version `v1.1.0` package name suffix `archfix` is renamed to `fix` to comply to AUR package naming conventions.
Upgrading to `v1.1.0` is the same as upgrading to `v1.0.0`. Please read *Upgrading/migrating to `v1.0.0`* for necessary steps to upgrade to `v1.1.0` from any tag prior to it.
In version `v1.1.0` package name suffix `-archfix` is renamed to `-fix` to comply to AUR package naming conventions.
Upgrading to `v1.1.0` is the same as upgrading to `v1.0.0`. Please read *Upgrading to `v1.0.0`* for necessary steps to upgrade to `v1.1.0` from any tag prior to it.

## Test

Expand All @@ -35,7 +35,7 @@ Test your webcam by running script `test.sh`.

### Chromium-based browsers

If you want to check, whether your camera works in Chromium-based Browsers (like Chrome, Brave, etc.) you can use [this website](https://webrtc.github.io/samples/src/content/devices/input-output/) to do so.
If you want to check, whether your camera works in Chromium-based Browsers (like Chrome, Brave, etc.) you can use [this website](https://webrtc.github.io/samples/src/content/devices/input-output/) to do so. To use Firefox, read *Make camera work in Firefox and some Electron-based applications*

### GNOME Cheese

Expand All @@ -47,10 +47,23 @@ Example: `sudo cheese -d "Virtual Camera"`

Run shell script `uninstall.sh` to disable/stop services and uninstall all previously installed packages.

## Make camera work in Firefox and Electron-based applications
## Make camera work in Firefox and some Electron-based applications

The camera should now work without any major issues in many applications (e.g. Chromium, OBS Studio) but it might not work correctly in some other applications (e.g. FireFox, Discord) due to the default NV12 format not being supported.
The camera should now work without any major issues in many applications (e.g. Chromium, OBS Studio) but it might not work correctly in some other ones (e.g. FireFox, Discord) due to the default NV12 format not being supported.

This can be fixed by running the install.sh script with a `--workaround flag`, which will edit `/etc/systemd/system/v4l2-relayd.service.d/override.conf` to convert the camera output to the YUY2 format.
This can be fixed by running the install.sh script with a `--workaround` flag, which will edit `/etc/systemd/system/v4l2-relayd.service.d/override.conf` to convert the camera output to the YUY2 format.

Please note that some applications (e.g. GNOME Cheese) will still very likely not work. This is due to Intel's driver just being low-quality. There is an [issue](https://github.com/stefanpartheym/archlinux-ipu6-webcam/issues/1) curently open for this.
Please note that some applications (e.g. GNOME Cheese) might still not work. This is due to Intel's driver just being low-quality. There is an [issue](https://github.com/stefanpartheym/archlinux-ipu6-webcam/issues/1) curently open for this.


## Tips and tricks

### Remove the warnings from an AUR helper

Some AUR helpers will warn you of some packages installed by `install.sh` not being in the Arch User Repository. There is usually a way to prevent these messages from showing up using the configuration file of the helper.

For example, if you're using paru, you might want to add the following to your `/etc/paru.conf` (or your user's config):

```
NoWarn = intel-ipu6-dkms-git-fix intel-ipu6ep-camera-hal-git-fix v4l2-relayd v4l2loopback-dkms-git-fix
```
2 changes: 1 addition & 1 deletion intel-ipu6ep-camera-hal-git/PKGBUILD
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
_ipu_ver=ipu6ep
pkgname=intel-ipu6ep-camera-hal-git-fix
_pkgname=ipu6-camera-hal
pkgver=r52.3729289
pkgver=r56.884b81a
pkgrel=1
pkgdesc="Intel IPU6 camera HAL (Alder Lake)"
arch=('x86_64')
Expand Down

0 comments on commit 4d33274

Please sign in to comment.