# camlet

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

# 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), avcodec, avformat, pulseaudio, 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 libpulse-dev libavcodec-dev libavformat-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
  https://github.com/libsdl-org/SDL/issues/9706. This bug has been fixed now, so hopefully
  it 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.