Initial commit - YT Converter

Author: thenullastris

.gitignore

@@ -0,0 +1,6 @@
+dist/
+build/
+appimage-build/
+*.spec
+__pycache__/
+AppDir/

AppImageBuilder.yml

@@ -0,0 +1,45 @@
+version: 1
+script:
+  - rm -rf AppDir || true
+
+AppDir:
+  path: ./AppDir
+  app_info:
+    id: com.khinphunnadet.ytconverter
+    name: YT Converter
+    icon: yt-converter
+    version: 1.0.0
+    exec: usr/bin/python3
+    exec_args: "$APPDIR/usr/src/app.py $@"
+
+  apt:
+    arch: amd64
+    sources:
+      - sourceline: 'deb [arch=amd64] http://archive.ubuntu.com/ubuntu jammy main restricted universe multiverse'
+        key_url: 'https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x871920D1991BC93C'
+    include:
+      - python3
+      - python3-pip
+      - python3-tk
+      - ffmpeg
+      - libgtk-3-0
+    exclude: []
+
+  files:
+    include: []
+    exclude:
+      - usr/share/man
+      - usr/share/doc/*/README.*
+      - usr/share/doc/*/changelog.*
+      - usr/share/doc/*/NEWS.*
+      - usr/share/doc/*/TODO.*
+
+  after_bundle:
+    - pip3 install --target=$APPDIR/usr/lib/python3/dist-packages customtkinter yt-dlp
+    - mkdir -p $APPDIR/usr/src
+    - cp app.py $APPDIR/usr/src/
+
+AppImage:
+  arch: x86_64
+  update-information: None
+  sign-key: None

README.md

@@ -0,0 +1,34 @@
+# YT Converter
+
+A simple YouTube video/audio downloader for Linux, built with Python and CustomTkinter.
+
+## Features
+- Download YouTube videos as MP3 (audio) or MP4 (video)
+- Quality selector: Best / 720p / 480p
+- Real-time download progress bar
+- Dark theme UI
+- Saves to `~/Downloads` automatically
+
+## Requirements
+- Python 3.10+
+- ffmpeg (`sudo apt install ffmpeg`)
+
+## Run from source
+```bash
+git clone https://github.com/thenullastris/yt-converter.git
+cd yt-converter
+chmod +x run.sh
+./run.sh
+```
+
+## Build executable
+```bash
+chmod +x build-appimage.sh
+./build-appimage.sh
+```
+
+## Download
+Grab the latest binary from [Releases](https://github.com/thenullastris/yt-converter/releases).
+
+## Built by
+[TheNullAstris](https://github.com/thenullastris)

app.py

@@ -0,0 +1,115 @@
+#!/usr/bin/env python3
+import customtkinter as ctk
+import yt_dlp
+import threading
+import os
+
+ctk.set_appearance_mode("dark")
+ctk.set_default_color_theme("blue")
+
+DOWNLOAD_DIR = os.path.expanduser("~/Downloads")
+
+class YTConverterApp(ctk.CTk):
+    def __init__(self):
+        super().__init__()
+        self.title("YT Converter")
+        self.geometry("520x420")
+        self.resizable(False, False)
+
+        # Title
+        ctk.CTkLabel(self, text="YouTube Converter", font=ctk.CTkFont(size=22, weight="bold")).pack(pady=(24, 4))
+        ctk.CTkLabel(self, text="Download videos or audio from YouTube", text_color="gray").pack()
+
+        # URL input
+        self.url_entry = ctk.CTkEntry(self, placeholder_text="Paste YouTube URL here...", width=420, height=40)
+        self.url_entry.pack(pady=20)
+
+        # Format frame
+        fmt_frame = ctk.CTkFrame(self, fg_color="transparent")
+        fmt_frame.pack()
+        ctk.CTkLabel(fmt_frame, text="Format:").pack(side="left", padx=(0, 12))
+        self.format_var = ctk.StringVar(value="mp3")
+        ctk.CTkRadioButton(fmt_frame, text="MP3 (Audio)", variable=self.format_var, value="mp3").pack(side="left", padx=8)
+        ctk.CTkRadioButton(fmt_frame, text="MP4 (Video)", variable=self.format_var, value="mp4").pack(side="left", padx=8)
+
+        # Quality frame
+        qual_frame = ctk.CTkFrame(self, fg_color="transparent")
+        qual_frame.pack(pady=8)
+        ctk.CTkLabel(qual_frame, text="Quality:").pack(side="left", padx=(0, 12))
+        self.quality_var = ctk.StringVar(value="best")
+        ctk.CTkRadioButton(qual_frame, text="Best", variable=self.quality_var, value="best").pack(side="left", padx=8)
+        ctk.CTkRadioButton(qual_frame, text="720p", variable=self.quality_var, value="720").pack(side="left", padx=8)
+        ctk.CTkRadioButton(qual_frame, text="480p", variable=self.quality_var, value="480").pack(side="left", padx=8)
+
+        # Progress bar
+        self.progress = ctk.CTkProgressBar(self, width=420)
+        self.progress.pack(pady=16)
+        self.progress.set(0)
+
+        # Status
+        self.status = ctk.CTkLabel(self, text="Ready", text_color="gray")
+        self.status.pack()
+
+        # Button
+        self.btn = ctk.CTkButton(self, text="⬇  Convert & Download", width=220, height=44,
+                                  font=ctk.CTkFont(size=14, weight="bold"), command=self.start_download)
+        self.btn.pack(pady=18)
+
+        # Output folder label
+        ctk.CTkLabel(self, text=f"Saves to: {DOWNLOAD_DIR}", text_color="gray",
+                     font=ctk.CTkFont(size=11)).pack()
+
+    def start_download(self):
+        url = self.url_entry.get().strip()
+        if not url:
+            self.status.configure(text="⚠️  Please enter a URL", text_color="orange")
+            return
+        self.btn.configure(state="disabled", text="Downloading...")
+        self.progress.set(0)
+        self.status.configure(text="Starting...", text_color="gray")
+        threading.Thread(target=self.download, args=(url,), daemon=True).start()
+
+    def download(self, url):
+        fmt = self.format_var.get()
+        quality = self.quality_var.get()
+
+        def progress_hook(d):
+            if d['status'] == 'downloading':
+                total = d.get('total_bytes') or d.get('total_bytes_estimate', 0)
+                downloaded = d.get('downloaded_bytes', 0)
+                if total:
+                    pct = downloaded / total
+                    self.progress.set(pct)
+                    self.status.configure(text=f"Downloading... {int(pct*100)}%", text_color="gray")
+            elif d['status'] == 'finished':
+                self.status.configure(text="Processing...", text_color="gray")
+
+        if fmt == "mp3":
+            ydl_opts = {
+                'format': 'bestaudio/best',
+                'outtmpl': os.path.join(DOWNLOAD_DIR, '%(title)s.%(ext)s'),
+                'progress_hooks': [progress_hook],
+                'postprocessors': [{'key': 'FFmpegExtractAudio', 'preferredcodec': 'mp3', 'preferredquality': '192'}],
+            }
+        else:
+            fmt_str = 'bestvideo+bestaudio/best' if quality == 'best' else f'bestvideo[height<={quality}]+bestaudio/best'
+            ydl_opts = {
+                'format': fmt_str,
+                'outtmpl': os.path.join(DOWNLOAD_DIR, '%(title)s.%(ext)s'),
+                'progress_hooks': [progress_hook],
+                'merge_output_format': 'mp4',
+            }
+
+        try:
+            with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+                ydl.download([url])
+            self.progress.set(1)
+            self.status.configure(text="✅ Done! File saved to ~/Downloads", text_color="#4CAF50")
+        except Exception as e:
+            self.status.configure(text=f"❌ Error: {str(e)[:60]}", text_color="#f44336")
+        finally:
+            self.btn.configure(state="normal", text="⬇  Convert & Download")
+
+if __name__ == "__main__":
+    app = YTConverterApp()
+    app.mainloop()

appimage/yt-converter.desktop

@@ -0,0 +1,8 @@
+[Desktop Entry]
+Name=YT Converter
+Comment=Download and convert YouTube videos
+Exec=app.py
+Icon=yt-converter
+Type=Application
+Categories=AudioVideo;Network;
+Terminal=false

build-appimage.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+set -e
+
+echo "================================================"
+echo "  YT Converter - AppImage Builder"
+echo "================================================"
+
+# Install appimage-builder if not present
+if ! command -v appimage-builder &> /dev/null; then
+    echo "📦 Installing appimage-builder..."
+    sudo apt install -y appimage-builder
+fi
+
+# Clean previous build
+rm -rf AppDir *.AppImage 2>/dev/null || true
+
+# Build
+echo "🔨 Building AppImage..."
+appimage-builder --recipe AppImageBuilder.yml
+
+echo ""
+echo "✅ Done! Your AppImage is ready:"
+ls -lh *.AppImage
+
+echo ""
+echo "To run it:"
+echo "  chmod +x *.AppImage"
+echo "  ./*.AppImage"

requirements.txt

@@ -0,0 +1,2 @@
+customtkinter
+yt-dlp

run.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+set -e
+
+echo "================================================"
+echo "  YT Converter - Setup & Run"
+echo "================================================"
+
+# Check Python
+if ! command -v python3 &> /dev/null; then
+    echo "❌ Python3 not found. Install with: sudo apt install python3"
+    exit 1
+fi
+
+# Check tkinter
+python3 -c "import tkinter" 2>/dev/null || {
+    echo "⚠️  tkinter not found. Installing..."
+    sudo apt install -y python3-tk
+}
+
+# Check ffmpeg
+if ! command -v ffmpeg &> /dev/null; then
+    echo "⚠️  ffmpeg not found. Installing..."
+    sudo apt install -y ffmpeg
+fi
+
+# Install dependencies
+echo "📦 Installing Python dependencies..."
+pip3 install customtkinter yt-dlp --break-system-packages -q
+
+# Run the app
+echo "🚀 Launching YT Converter..."
+python3 app.py