From 6f6d3683c3be9b975a3e58cf228f24991f08fc27 Mon Sep 17 00:00:00 2001 From: Conway Date: Fri, 28 Aug 2026 16:01:31 -0400 Subject: updated README --- README.md | 28 ++++++++++++++++++++++++++++ app.py | 22 ---------------------- 2 files changed, 28 insertions(+), 22 deletions(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..00c81f5 --- /dev/null +++ b/README.md @@ -0,0 +1,28 @@ +# Dlit - Download It! v1.9 + +It's a tiny terminal wrapper for yt-dlp. Downloading your favorite music off of YouTube should be absurdly easy. Now it is! + +Paste a link at the prompt; downloads queue and run serially in the +background. Commands: :mp3, :video, :none switch the active preset. +Ctrl-D or :q to quit (lets an in-flight download finish; Ctrl-C aborts). + +Currently this only supports linux, but you could easily rig this to work on windows or whatever. + +Ensure you have yt-dlp installed. + +Add it to your favorite shell with alias dlit='python3 ~/Repositories/dlit/app.py', then type 'dlit' whenever you wanna download something. + + + +v1.9: a playlist whose fan-out wouldn't fit on screen no longer prints a +queued line per entry up front, it prints a one-line summary and each +entry's line appears once, when its download starts; a job whose line +scrolled off-screen gets a fresh line above the prompt on its next status +change instead of updating invisibly, so the active download is always on +screen. + +v1.8: link resolution runs off the main thread so the prompt never freezes +on a slow probe; tracked lines that scroll past the top of the screen are +untracked instead of corrupting the display; job bookkeeping is pruned +rather than growing forever; playlist truncation at PLAYLIST_LIMIT is +reported; quitting drains the queue but finishes the download in flight. diff --git a/app.py b/app.py index 39e7f0c..29df13d 100644 --- a/app.py +++ b/app.py @@ -1,28 +1,6 @@ #!/usr/bin/env python3 -"""DLit — Download It! - -a tiny terminal wrapper for yt-dlp. - -Paste a link at the prompt; downloads queue and run serially in the -background. Commands: :mp3, :video, :none switch the active preset. -Ctrl-D or :q to quit (lets an in-flight download finish; Ctrl-C aborts). - -v1.8: link resolution runs off the main thread so the prompt never freezes -on a slow probe; tracked lines that scroll past the top of the screen are -untracked instead of corrupting the display; job bookkeeping is pruned -rather than growing forever; playlist truncation at PLAYLIST_LIMIT is -reported; quitting drains the queue but finishes the download in flight. - -v1.9: a playlist whose fan-out wouldn't fit on screen no longer prints a -queued line per entry up front — it prints a one-line summary and each -entry's line appears once, when its download starts; a job whose line -scrolled off-screen gets a fresh line above the prompt on its next status -change instead of updating invisibly, so the active download is always on -screen. -""" from __future__ import annotations - import itertools import os import queue -- cgit v1.3.1