streamtuner2 minimal dependency overview
========================================

1. Minimum to start the application
-----------------------------------

Required:
- python3
- python3-gi
- python3-requests
- python3-pyquery
- python3-lxml
- python3-pillow
- python3-xdg

Debian/Ubuntu example:
  sudo apt install python3 python3-gi python3-requests python3-pyquery python3-lxml python3-pillow python3-xdg

Pip-only Python modules example:
  python3 -m pip install requests pyquery lxml pillow pyxdg

Note:
- GTK bindings come from system packages, not just pip.
- Optional plugins may need extra packages such as python3-keybinder or python3-dbus.


2. Minimum for playback
-----------------------

Startup dependencies plus at least one media player and one browser:
- vlc   or another supported audio/video player
- firefox or another browser

The default config tries common binaries such as:
- vlc --one-instance
- totem
- xdg-open / firefox / sensible-browser

Debian/Ubuntu example:
  sudo apt install vlc firefox

Optional but recommended for video/youtube-like playback:
- yt-dlp

Debian/Ubuntu example:
  sudo apt install yt-dlp


3. Minimum for recording
------------------------

Recording needs playback/startup dependencies plus:
- streamripper   for audio/* recording
- a terminal emulator, for example:
  - x-terminal-emulator
  - xfce4-terminal
  - gnome-terminal
  - xterm

Debian/Ubuntu example:
  sudo apt install streamripper xterm

For video/youtube-style recording:
- yt-dlp

Debian/Ubuntu example:
  sudo apt install yt-dlp

Notes:
- Yes, streamripper must be installed if you want the default Record button for radio/audio streams to work.
- Alternatives such as fIcy/fPls are possible, but they are not the default command in this repository.
- VLC alone is not enough for the default audio recording flow.


4. Minimum for bundle/package builds from Makefile
--------------------------------------------------

`make pyz` only needs:
- python3

Legacy bundle targets such as `make deb`, `make rpm`, `make tar`
and `make exe` still need:
- make
- gzip
- xpm   from http://fossil.include-once.org/xpm/

Optional but useful for metadata syncing:
- versionnum / `version`   from http://fossil.include-once.org/versionnum/

Notes:
- `make pyz` no longer requires either `xpm` or the `version` command.
- It falls back to the `# version:` metadata in `st2.py`.
- `make ver` still benefits from `version`, but now writes a basic `PKG-INFO`
  fallback if the tool is missing.
- Native distro package metadata is kept separately in `debian/` and
  `packaging/rpm/streamtuner2.spec`.
