Skip to content

Commit 464d466

Browse files
committed
doc(readme): integration with howdy
1 parent 676a65b commit 464d466

1 file changed

Lines changed: 19 additions & 2 deletions

File tree

README.md

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,12 +8,29 @@ Provides support for infrared cameras that are not directly enabled out-of-the b
88
Download the latest [linux-enable-ir-emitter-x.x.x.systemd.x86-64.tar.gz](https://github.com/EmixamPP/linux-enable-ir-emitter/releases). Then execute:
99
```
1010
sudo tar -C / --no-same-owner -m -h -vxzf linux-enable-ir-emitter*.tar.gz
11+
```
12+
13+
To uninstall the tool, see [docs/uninstallation.md](docs/uninstallation.md) for the instructions.
14+
15+
### Integration with Howdy
16+
In all file returned by `grep -rl howdy /etc/pam.d`, add the following line before the one mentioning "howdy":
17+
```
18+
auth optional pam_exec.so /usr/local/bin/linux-enable-ir-emitter run
19+
```
20+
21+
Note that the path to the binary may vary depending on your installation method. You can determine the correct path by running `which linux-enable-ir-emitter`.
22+
23+
### Integration with other program
24+
For version 6.x.x, we still provide a systemd service that, for most cameras, should be sufficient to keep the ir emitter enabled at all times:
25+
26+
```
1127
sudo systemctl enable --now linux-enable-ir-emitter
1228
```
29+
Note that this approach is now deprecated and support will be removed from version 7.x.x.
1330

14-
We also support the OpenRC service manager. See [docs/manual-build.md](docs/manual-build.md) for information on how to build the project.
31+
However, this approach is more of a workaround than a proper solution. Therefore, if your goal is to use Howdy, please refer to the previous section. Otherwise, you will need to find a way to run the command `linux-enable-ir-emitter run` before using the camera in your program.
1532

16-
To uninstall the tool, see [docs/uninstallation.md](docs/uninstallation.md) for the instructions.
33+
We also support the OpenRC service manager. See [docs/manual-build.md](docs/manual-build.md) for information on how to build the project.
1734

1835
## How do I enable my infrared emitter?
1936
1. Stand in front of and close to the camera and make sure the room is well lit.

0 commit comments

Comments
 (0)