videostore 0.1.0__tar.gz

videostore-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CallMeBakugo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

videostore-0.1.0/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.5
+Name: videostore
+Version: 0.1.0
+Summary: Small, single-window yt-dlp wrapper. Paste, download, close. No memory.
+Project-URL: Homepage, https://github.com/CallMeBakugo/VideoStore
+Project-URL: Source, https://github.com/CallMeBakugo/VideoStore
+Author: CallMeBakugo
+License: MIT
+License-File: LICENSE
+Keywords: audio,downloader,pyside6,video,yt-dlp
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.10
+Requires-Dist: pyside6>=6.6
+Description-Content-Type: text/markdown
+
+# VideoStore
+
+Small, single-window yt-dlp wrapper for the desktop. Paste a link, pick a
+format, hit Download. Nothing else.
+
+    pipx install videostore
+    videostore
+
+## What it is
+
+- URL field, format dropdown (best video+audio, ≤1080p, ≤720p, mp3,
+  best audio), download-folder field with a picker, Download and Clear.
+- Downloads run in a worker thread; the progress bar fills live.
+- Defaults to ~/Downloads.
+
+## What it is not
+
+- No history, no logs, no queue, no memory. Paste, download, close.
+- Not a library, not a service. A box.
+
+## Requirements
+
+- Python 3.10+
+- PySide6 (installed automatically)
+- `yt-dlp` on PATH (install via your package manager or `pipx install yt-dlp`)
+
+## Layout
+
+- `videostore/core.py` — pure download logic (yt-dlp subprocess, progress
+  parsing, cancel). Zero GUI imports.
+- `videostore/app.py` — the PySide6 shell.
+
+The Omarchy bar-widget sibling lives in
+[VideoStoreBar](https://github.com/CallMeBakugo/VideoStoreBar).

videostore-0.1.0/README.md

@@ -0,0 +1,34 @@
+# VideoStore
+
+Small, single-window yt-dlp wrapper for the desktop. Paste a link, pick a
+format, hit Download. Nothing else.
+
+    pipx install videostore
+    videostore
+
+## What it is
+
+- URL field, format dropdown (best video+audio, ≤1080p, ≤720p, mp3,
+  best audio), download-folder field with a picker, Download and Clear.
+- Downloads run in a worker thread; the progress bar fills live.
+- Defaults to ~/Downloads.
+
+## What it is not
+
+- No history, no logs, no queue, no memory. Paste, download, close.
+- Not a library, not a service. A box.
+
+## Requirements
+
+- Python 3.10+
+- PySide6 (installed automatically)
+- `yt-dlp` on PATH (install via your package manager or `pipx install yt-dlp`)
+
+## Layout
+
+- `videostore/core.py` — pure download logic (yt-dlp subprocess, progress
+  parsing, cancel). Zero GUI imports.
+- `videostore/app.py` — the PySide6 shell.
+
+The Omarchy bar-widget sibling lives in
+[VideoStoreBar](https://github.com/CallMeBakugo/VideoStoreBar).

videostore-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "videostore"
+version = "0.1.0"
+description = "Small, single-window yt-dlp wrapper. Paste, download, close. No memory."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "CallMeBakugo" }]
+keywords = ["yt-dlp", "downloader", "video", "audio", "pyside6"]
+classifiers = [
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Multimedia :: Video",
+]
+dependencies = [
+    "PySide6>=6.6",
+]
+
+[project.urls]
+Homepage = "https://github.com/CallMeBakugo/VideoStore"
+Source = "https://github.com/CallMeBakugo/VideoStore"
+
+[project.scripts]
+videostore = "videostore.app:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["videostore"]

videostore-0.1.0/videostore/__init__.py

@@ -0,0 +1,3 @@
+"""VideoStore: paste, download, close. No memory."""
+
+__version__ = "0.1.0"

videostore-0.1.0/videostore/app.py

@@ -0,0 +1,185 @@
+#!/usr/bin/env python3
+"""ytdl-box: single-window yt-dlp wrapper. Paste, choose, download. No memory."""
+
+import sys
+
+from PySide6.QtCore import Qt, QThread, Signal
+from PySide6.QtWidgets import (
+    QApplication,
+    QComboBox,
+    QFileDialog,
+    QHBoxLayout,
+    QLabel,
+    QLineEdit,
+    QMainWindow,
+    QProgressBar,
+    QPushButton,
+    QVBoxLayout,
+    QWidget,
+)
+
+try:
+    from videostore.core import FORMATS, Grabber
+except ImportError:
+    from core import FORMATS, Grabber
+
+BG = "#08181c"
+PANEL = "#0d2426"
+ACCENT = "#00e5c7"
+LIME = "#7dff9a"
+TEXT = "#c9e7d4"
+
+QSS = f"""
+QMainWindow {{ background: {BG}; }}
+QWidget {{ background: {BG}; color: {TEXT};
+           font-family: 'FantasqueSansM Nerd Font';
+           font-size: 14px; }}
+QLineEdit, QComboBox {{
+    background: {PANEL}; color: {TEXT};
+    border: 1px solid #1d3a3c; border-radius: 6px; padding: 6px;
+}}
+QPushButton {{
+    background: {PANEL}; color: {ACCENT};
+    border: 1px solid {ACCENT}; border-radius: 6px; padding: 6px 16px;
+}}
+QPushButton:hover {{ background: #123; color: {LIME}; }}
+QPushButton:disabled {{ color: #4a5f5f; border-color: #2a4446; }}
+QProgressBar {{
+    background: {PANEL}; border: 1px solid #1d3a3c;
+    border-radius: 6px; text-align: center; height: 16px;
+}}
+QProgressBar::chunk {{ background: {ACCENT}; border-radius: 5px; }}
+QLabel#status {{ color: {LIME}; }}
+QLabel#title {{ font-family: Cinzel; font-size: 16px; color: {ACCENT}; }}
+"""
+
+
+class GrabWorker(QThread):
+    progress = Signal(float)
+    file_sig = Signal(str)
+    done = Signal(str)
+    failed = Signal(str)
+
+    def __init__(self, grabber: Grabber, cmd: list[str]) -> None:
+        super().__init__()
+        self.grabber = grabber
+        self.cmd = cmd
+
+    def run(self) -> None:  # pragma: no cover - thread body
+        try:
+            final = self.grabber.run(
+                self.cmd,
+                on_progress=lambda p: self.progress.emit(p),
+                on_file=lambda f: self.file_sig.emit(f),
+            )
+            self.done.emit(final)
+        except Exception as exc:  # noqa: BLE001
+            self.failed.emit(str(exc))
+
+
+class Box(QMainWindow):
+    def __init__(self) -> None:
+        super().__init__()
+        self.grabber = Grabber()
+        self.worker: GrabWorker | None = None
+        self.setWindowTitle("VideoStore")
+        self.setMinimumWidth(520)
+        self.build_ui()
+
+    def build_ui(self) -> None:
+        root = QWidget()
+        self.setCentralWidget(root)
+        v = QVBoxLayout(root)
+        v.setContentsMargins(12, 12, 12, 12)
+        v.setSpacing(8)
+
+        title = QLabel("VideoStore")
+        title.setObjectName("title")
+        title.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        v.addWidget(title)
+
+        self.url = QLineEdit()
+        self.url.setPlaceholderText("Paste link…")
+        v.addWidget(self.url)
+
+        self.fmt = QComboBox()
+        for key, spec in FORMATS.items():
+            self.fmt.addItem(spec["label"], userData=key)
+        v.addWidget(self.fmt)
+
+        path_row = QHBoxLayout()
+        self.outdir = QLineEdit(self.grabber.default_outdir())
+        browse = QPushButton("Where?")
+        browse.setFixedWidth(84)
+        browse.clicked.connect(self.on_browse)
+        path_row.addWidget(self.outdir, 1)
+        path_row.addWidget(browse)
+        v.addLayout(path_row)
+
+        btn_row = QHBoxLayout()
+        self.btn_dl = QPushButton("Download")
+        self.btn_clear = QPushButton("Clear")
+        self.btn_dl.clicked.connect(self.on_download)
+        self.btn_clear.clicked.connect(self.on_clear)
+        btn_row.addWidget(self.btn_dl)
+        btn_row.addWidget(self.btn_clear)
+        v.addLayout(btn_row)
+
+        self.bar = QProgressBar()
+        self.bar.setRange(0, 100)
+        v.addWidget(self.bar)
+
+        self.status = QLabel("")
+        self.status.setObjectName("status")
+        v.addWidget(self.status)
+
+    # ---- handlers ----
+    def on_browse(self) -> None:
+        d = QFileDialog.getExistingDirectory(self, "Download to", self.outdir.text())
+        if d:
+            self.outdir.setText(d)
+
+    def on_download(self) -> None:
+        url = self.url.text().strip()
+        if not url:
+            self.status.setText("Paste a link first.")
+            return
+        try:
+            cmd = self.grabber.build_cmd(url, self.fmt.currentData(), self.outdir.text())
+        except Exception as exc:  # noqa: BLE001
+            self.status.setText(f"Can't start: {exc}")
+            return
+        self.btn_dl.setEnabled(False)
+        self.status.setText("Fetching…")
+        self.worker = GrabWorker(self.grabber, cmd)
+        self.worker.progress.connect(self.bar.setValue)
+        self.worker.file_sig.connect(lambda f: self.status.setText(f"→ {f}"))
+        self.worker.done.connect(self.on_done)
+        self.worker.failed.connect(self.on_fail)
+        self.worker.start()
+
+    def on_done(self, final: str) -> None:
+        self.btn_dl.setEnabled(True)
+        self.bar.setValue(100)
+        self.status.setText(f"Done.{(' ' + final) if final else ''} Next link.")
+
+    def on_fail(self, msg: str) -> None:
+        self.btn_dl.setEnabled(True)
+        self.status.setText(f"Failed: {msg}")
+
+    def on_clear(self) -> None:
+        self.url.clear()
+        self.bar.setValue(0)
+        self.status.setText("")
+
+
+def main() -> None:
+    app = QApplication(sys.argv)
+    app.setStyleSheet(QSS)
+    w = Box()
+    w.show()
+    sys.exit(app.exec())
+
+
+if __name__ == "__main__":
+    main()

videostore-0.1.0/videostore/core.py

@@ -0,0 +1,111 @@
+"""ytdl-box core: pure download logic, zero GUI imports.
+
+Wraps the yt-dlp CLI as a subprocess so the same grab() contract can drive
+the PySide6 desktop app today and an Android (BeeWare/Kivy) shell later.
+"""
+
+import os
+import re
+import subprocess
+from collections.abc import Callable
+
+FORMATS = {
+    "label_best": {
+        "label": "Best video+audio",
+        "args": ["-f", "bv*+ba/b"],
+    },
+    "label_1080": {
+        "label": "Best ≤1080p",
+        "args": ["-f", "bv*[height<=1080]+ba/b[height<=1080]/b"],
+    },
+    "label_720": {
+        "label": "Best ≤720p",
+        "args": ["-f", "bv*[height<=720]+ba/b[height<=720]/b"],
+    },
+    "label_audio_mp3": {
+        "label": "Audio only (mp3)",
+        "args": ["-x", "--audio-format", "mp3"],
+    },
+    "label_audio_best": {
+        "label": "Audio only (best)",
+        "args": ["-f", "ba/b"],
+    },
+}
+
+OUTPUT_TEMPLATE = "%(title)s.%(ext)s"
+
+PROGRESS_RE = re.compile(r"(\d+(?:\.\d+)?)%")
+DEST_RE = re.compile(r"Destination:\s+(.+)$")
+Merging_RE = re.compile(r"\[Merger\].*?into\s+(.+)$")
+
+
+class Grabber:
+    """Builds and runs yt-dlp. Pure logic; safe to headless-test."""
+
+    def __init__(self, yt_dlp_bin: str = "yt-dlp") -> None:
+        self.bin = yt_dlp_bin
+        self.proc: subprocess.Popen | None = None  # set by run(); kill via cancel()
+
+    def cancel(self) -> None:
+        """Terminate the running yt-dlp, if any."""
+        if self.proc and self.proc.poll() is None:
+            self.proc.terminate()
+
+    @staticmethod
+    def default_outdir() -> str:
+        return os.path.expanduser("~/Downloads")
+
+    def build_cmd(self, url: str, format_key: str, outdir: str) -> list[str]:
+        fmt = FORMATS.get(format_key)
+        if fmt is None:
+            raise ValueError(f"unknown format key: {format_key}")
+        url = url.strip()
+        if not url:
+            raise ValueError("empty URL")
+        outdir = os.path.expanduser(outdir)
+        os.makedirs(outdir, exist_ok=True)
+        return [
+            self.bin,
+            *fmt["args"],
+            "--no-playlist",
+            "--no-mtime",
+            "--restrict-filenames",
+            "--newline",  # progress: one line per update, easy to parse
+            "-o", os.path.join(outdir, OUTPUT_TEMPLATE),
+            "--", url,
+        ]
+
+    def run(
+        self,
+        cmd: list[str],
+        on_progress: Callable[[float], None],
+        on_file: Callable[[str], None],
+    ) -> str:
+        """Run the command synchronously; parse progress/dest from stdout."""
+        final_file = ""
+        proc = subprocess.Popen(
+            cmd,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            text=True,
+        )
+        self.proc = proc
+        assert proc.stdout is not None
+        for line in proc.stdout:
+            line = line.strip()
+            m = PROGRESS_RE.search(line)
+            if m:
+                on_progress(float(m.group(1)))
+                continue
+            d = DEST_RE.search(line)
+            if d:
+                on_file(d.group(1))
+                continue
+            d = Merging_RE.search(line)
+            if d:
+                final_file = d.group(1)
+                on_file(final_file)
+        rc = proc.wait()
+        if rc != 0:
+            raise RuntimeError(f"yt-dlp exited with code {rc}")
+        return final_file