Skip to main content

yt-queue

CLI to keep track of videos in Youtube playlists

cli

See yt-queue -h and yt-queue <subcommand> -h for details.

Examples:

# create a new file
yt-queue create example.ytq.json "https://www.youtube.com/playlist?list=PL0pg4HdU1lNMtRzycn3wbKyfQO5vQZja9"

# refresh a file, only if it wasnt recently updated
yt-queue refresh example.ytq.json --only-if-older=1day

# get the "new" items
yt-queue filter --no-status example.ytq.json

# read the values of a video from the file
yt-queue read-field example.ytq.json "C0DPdy98e4c" url
yt-queue read-field example.ytq.json "C0DPdy98e4c" title

# set the status
yt-queue set-status example.ytq.json "C0DPdy98e4c" some-text-status
yt-queue filter --status=some-text-status example.ytq.json

# more filter options
yt-queue filter --title "TEST VIDEO" example.ytq.json
yt-queue filter --min-duration 3 example.ytq.json
yt-queue filter --max-duration 20 example.ytq.json

output

Most cli subcommands' output (stdout) is parsable. stderr is used for logging:

  • filter returns the matching video ids, 1 per line
  • read-field returns the value of the field for the given video id

Other subcommands output should not be parsed - they contain either progress or verbose logging (including from yt-dlp)

development

setup (or recreate) environment with source dev/init.sh

or manually:

python3 -m venv .env
source .env/bin/activate
pip install --editable .
pip install '.[dev]'

other dependencies: shellcheck

tests: ./check.sh

test the built packages: ./dist-check.sh dist/...

Metadata

Release files for yt-queue 0.14.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 yt-queue 0.14.0
File Size Uploaded Provenance Actions
yt_queue-0.14.0.tar.gz 11.8 kB With provenance Details for yt_queue-0.14.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for yt-queue 0.14.0
File Interpreter ABI Platform Actions
yt_queue-0.14.0-py3-none-any.whl Python 3 none any Details for yt_queue-0.14.0-py3-none-any.whl

Total release size: 27.8 kB

Release files / yt_queue-0.14.0.tar.gz

Download URL yt_queue-0.14.0.tar.gz
Size 11.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9ec12f52f5908d444bf736b646962c491e84c8ffc7dc3487876e3d0480797492
BLAKE2b-256 checksum
How to use checksums
a32ace9fb9fb44613fa321f0eba90b82f653dcc0d3e750275b49b55c14c2c982
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Release files / yt_queue-0.14.0-py3-none-any.whl

Download URL yt_queue-0.14.0-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
dcc2eabbfdfb994a7b8102f99ff1dc898b883ae570cb072edc447f06c1b43664
BLAKE2b-256 checksum
How to use checksums
1c6f3af71c00421c92efa729935179b4ffc859670719f2299c921498466e0954
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.7

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

Security for yt-queue 0.14.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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for yt_queue-0.14.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 4, 2026.

Transparency log

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

0.14.0 This release

2 release files Full 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