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.13.9

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.13.9
File Size Uploaded Provenance Actions
yt_queue-0.13.9.tar.gz 11.5 kB With provenance Details for yt_queue-0.13.9.tar.gz

Built distribution (wheel)

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

Total release size: 27.5 kB

Release files / yt_queue-0.13.9.tar.gz

Download URL yt_queue-0.13.9.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
353565d92db331c2eb2f3fb0379a5b3dda64318c0b283ae6c2302334943a9f5b
BLAKE2b-256 checksum
How to use checksums
a3ab585caadca451d566c2b116d55e22ff724937a2968b4947ce9a2dcd2a5693
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 Aug 22, 2026.

Transparency log

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

Download URL yt_queue-0.13.9-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6b9f5d92574bc8b5f0900b1c139b76cbe9364058fbaceb59b2a7a633fb56edba
BLAKE2b-256 checksum
How to use checksums
29124ba4def73ca10eb4291d63a702dfa2bad0db8dd7fa7b19ccea950695e04e
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 Aug 22, 2026.

Transparency log

Security for yt-queue 0.13.9

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.13.9.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 Aug 22, 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.13.9 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