Skip to main content

video-bookmarks

@readwithai - X - blog - machine-aided reading - 📖⚡️🖋️

A command-line wrapper for the the mpv video player to create bookmarks in videos and audio files from te command-line. This can be useful when clipping videos for memes.

This is lightweight and easy to edit. The timestamps obtained may be used with ffmpeg.

Mostly vibe-coded at present! I can code, quantity of vibe coding will likely decrease over time.

Motivation

I quite like the command-line, and use it when I am not doing someting big. I wanted to cut out clips from a video from the command-line in order to share memes, but most of the tools were fiddley. So I decided to write this.

Alternatives and prior work

mplayer and mpv support scripting and you may be able to define a bookmarks system for them. This seemed too fiddle for my liking.

Video editors like [[Shotcut]] may be useful for this sort of thing. If you are posting on youtube or TikTok the short creators allow some good editing.

You could use vlc to get these timestamps.

Installation

Ensure mpv is installed:

sudo apt install mpv

You can then install video-bookmarks using pipx:

pipx install video-bookmarks

Usage

You can run video-bookmarks test.mp4. This then gives you a list of keybindings to run.

It will generate a bookmarks file called test.bookmarks.

About me

I am @readwithai. I create tools for reading, research and agency sometimes using the markdown editor Obsidian.

I also create a stream of tools that are related to carrying out my work.

I write about lots of things - including tools like this - on X. My blog is more about reading and research and agency.

Metadata

Release files for video-bookmarks 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for video-bookmarks 1.0.0
File Size Uploaded Provenance Actions
video_bookmarks-1.0.0.tar.gz 12.0 kB Without provenance Details for video_bookmarks-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for video-bookmarks 1.0.0
File Interpreter ABI Platform Actions
video_bookmarks-1.0.0-py3-none-any.whl Python 3 none any Details for video_bookmarks-1.0.0-py3-none-any.whl

Total release size: 22.0 kB

Release files / video_bookmarks-1.0.0.tar.gz

Download URL video_bookmarks-1.0.0.tar.gz
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
aa0039758e6915822c4849cb8916af0e742ac97a8e6936427a59099d934ef3bc
BLAKE2b-256 checksum
How to use checksums
41ba0394cffc5e5f2e700efa2a41d563c9baabab4a94d8d181a7c75cde971cea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Release files / video_bookmarks-1.0.0-py3-none-any.whl

Download URL video_bookmarks-1.0.0-py3-none-any.whl
Size 10.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cfadc323856fe540c48814a18700aeb62811ce7378a84cf1e98be11d86cdc0bb
BLAKE2b-256 checksum
How to use checksums
78528c286c19023656dd7a984ca4e509a619d7ca5bba4ed804cc4352c2a771d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.3

Security for video-bookmarks 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page