rtspfinder

Discover RTSP IP cameras on your local network, try common default credentials, and automatically save configuration when exactly one device is found.

admin:123456 is tried first, followed by a built-in list of common camera usernames and passwords.

Install

From PyPI:

pip install rtspfinder

From source:

pip install .
# optional: better multi-interface subnet detection
pip install rtspfinder[netifaces]

Quick start (auto mode)

With no arguments, rtspfinder:

1. Uses saved config if present (~/.config/rtspfinder/config.json) and connects to the stream
2. Otherwise scans the LAN for RTSP (port 554)
3. If one RTSP host is found, probes paths/credentials, writes config, and opens the stream
4. If several hosts exist but only one authenticates, still auto-configures and connects

In-terminal video (like ani-cli)

By default, when run from a TTY, video plays inside the terminal using mpv (--vo=kitty, tct, or caca) — same idea as ani-cli’s --no-detach in-terminal mpv.

brew install mpv ffmpeg    # required for TTY video
brew install chafa         # optional ASCII fallback
rtspfinder                 # discover → save → play in TTY
rtspfinder --tty           # force TTY even if auto-detection differs
rtspfinder --gui           # separate window (ffplay/mpv)

rtspfinder

Force a new scan:

rtspfinder --refresh

Print the saved URL for scripts:

rtspfinder --url

Skip auto-connect:

rtspfinder --no-connect

Camera controls (YCC365 Plus / Ginatex HTTP + ONVIF)

Per YCC365 docs: HTTP 80, RTSP 554, ONVIF 80.

Many of these cameras (including Ginatex/TAS-Tech firmware) expose ONVIF PTZ over HTTP without auth — same approach as the PTZ-YCC365 Home Assistant component.

# Discover HTTP/ONVIF endpoints (uses saved config if present)
rtspfinder controls --discover-only --save

# Interactive PTZ in the terminal: w/a/s/d move, x stop, q quit
rtspfinder controls

More commands

Config file permissions are set to 600 where supported.

Python API

from rtspfinder import auto_configure, load_config

result = auto_configure()
if result.configured:
    print(result.config.url)

Security

Only use on networks and devices you own or are authorized to test. Change default camera passwords after setup.

Publish to PyPI

pip install build twine
python -m build
twine check dist/*
twine upload dist/*

Use PyPI API tokens; do not commit credentials.

License

MIT — see LICENSE.