1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
# camlet
<img src="camlet.png">
Camlet is a webcam application for Linux.
It features
- Proper handling of disconnecting/reconnecting devices
- Capture JPEG and PNG images and MP4 (H264+AAC) videos
- Full selection of resolutions available from camera
- Remembers settings across program launches
## Installation
You can find .deb installers on the [releases page on GitHub](https://github.com/pommicket/camlet/releases).
If you want automatic updates, you can also
[add my repository to apt](https://s.pommicket.com/deb/), and just do
```sh
sudo apt install camlet
```
If you are on a non-Debian-based Linux
distribution, you will have to build from source (see instructions below).
## Usage
- <kbd>F1</kbd> - show this help text
- <kbd>F2</kbd> - show debug info
- <kbd>Space</kbd> - take a picture or start/stop recording video
- <kbd>Escape</kbd> - open/close settings
- <kbd>Ctrl</kbd>+<kbd>f</kbd> - open picture directory
- <kbd>Tab</kbd> - switch between picture and video
## Building from source
camlet requires meson-build, a C compiler, and the development libraries
for SDL2, SDL2\_ttf, GL (headers only), v4l2, udev, sodium, jpeglib (from IJG), ogg, vorbis, theora, and fontconfig.
These can all be installed on Debian/Ubuntu with
```sh
sudo apt install clang meson libv4l-dev libudev-dev libsodium-dev libfontconfig-dev libgl-dev libsdl2-dev libsdl2-ttf-dev libjpeg-dev libvorbis-dev libogg-dev libvpx-dev
```
You can build the debug version of camlet with `make` (outputs `camlet.debug`), the release
version with `make release` (outputs `release/camlet`), and install it with
`make install`, or e.g. `INSTALL_PREFIX=~/.local make install` to customize the installation directory (default: `/usr/local`).
You can also build the .deb installer with `make camlet.deb`.
## Debugging
- Known issue: pulseaudio audio capturing is broken on some versions of SDL2.30:
https://github.com/libsdl-org/SDL/issues/9706. This bug has been fixed now, so hopefully
the fix will make it to your computer soon.
If you find a bug, please create an issue on GitHub; it will be helpful to have
your settings and log file, located in `~/.config/camlet`.
You can try deleting/renaming your settings file as a temporary solution, to reset camlet to its default settings.
## Version history
<table>
<tr><th>Version</th> <th>Description</th> <th>Date</th></tr>
<tr><td>0.0.0</td> <td>Initial release</td> <td>2025 Feb 26</td></tr>
<tr><td>0.0.1</td> <td>Fix crash switching to video mode with no camera connected</td> <td>2025 Feb 26</td></tr>
</table>
## License
0BSD
|
