overc-clips
Cut analysis clips out of a YouTube video or a local file, through a web page, with no command line required.
Built for volleyball coaches handing clips to video-review sites, but there is nothing sport-specific in it. Point it at a video, mark the spans you want, and it produces the clips.
It runs two ways from one codebase:
- On your own machine. It starts a small web server and prints an address. Open that in a browser on the same machine, or on your phone if you are on the same wifi. The video processing happens on your computer; the phone is only the remote control.
- Hosted, like any other internal web app.
What you need
Python 3.10 or newer. That is all. ffmpeg and yt-dlp come with it — the install pulls a static ffmpeg build, so there is nothing to install separately and nothing to put on your PATH.
Works on macOS, Linux and Windows.
Install
pip install overc-clips
On current macOS and most Linux distributions that will refuse with a message about an "externally managed environment" — that is the operating system protecting its own Python, not an error in this package. Use a virtualenv:
python3 -m venv ~/.local/share/overc-clips/venv
~/.local/share/overc-clips/venv/bin/pip install overc-clips
~/.local/share/overc-clips/venv/bin/overc-clips serve
or install it with pipx, which does the same thing for you:
pipx install overc-clips
Use it
overc-clips serve # start the web UI, print the address to visit
overc-clips doctor # what it found on this machine, and what is missing
serve prints a local address and, if it can, a second one for other devices on
your network. Everything else happens in the browser: paste a video link, scrub
to the start and end of each clip, and make them.
Useful flags:
overc-clips serve --outdir ~/Movies/clips # where clips are written
overc-clips serve --port 8080 # default
overc-clips serve --token secret # require a token, for a shared network
Settings you would otherwise need a flag for — the output folder, how long clips are kept, the maximum clip length — are in the web UI itself, so someone who was handed a desktop shortcut can still change them.
Clips
Clips are named after the source video and their timestamps, so two cuts from one match never collide. Where each clip came from is written into the file as mp4 metadata, which survives the file being moved or shared, and the built-in library can group, search and file them.
Clips are deleted after 14 days by default, which the UI tells you on startup and lets you change or switch off.
Keeping it working
YouTube changes things regularly and an out-of-date yt-dlp is the usual cause of a download that suddenly fails. Updating it is independent of this package:
pip install -U yt-dlp # in whichever environment you installed into
overc-clips doctor reports the version it is using and where it came from.
Licence
GNU Affero General Public License, version 3. See LICENSE.
If you change it and pass it on, the changes come with it. The Affero part extends that to running a modified copy as a service for other people over a network — which for a web application is the case that matters. Improvements sent back are welcome.
This is early software and it changes often. Treat it as alpha: things move, and nothing here is supported.
1 maintainer
Metadata
1 maintainer
Release files for overc-clips 0.5.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| overc_clips-0.5.2.tar.gz | 243.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| overc_clips-0.5.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 493.7 kB
Release files / overc_clips-0.5.2.tar.gz
| Download URL | overc_clips-0.5.2.tar.gz |
|---|---|
| Size | 243.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
689c7a96e1938d62e68726ece4f7e7e81a23309cdf8a1a256dbfb6801961166a
|
|
BLAKE2b-256 checksum How to use checksums |
748496b72ec621e27bfd00da0e1df681ff189f9b9742861a4f80fb435277592f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / overc_clips-0.5.2-py3-none-any.whl
| Download URL | overc_clips-0.5.2-py3-none-any.whl |
|---|---|
| Size | 250.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b78a33781898f38264ce300b5edfe59b46c1d8aabb46111eae0c72dd2cef7d7c
|
|
BLAKE2b-256 checksum How to use checksums |
a1b9219458f6b793454a602bef599d1f53358fdea84d099ce257a08cd672f8a6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
