MEDIA RENAMER SUITE
Desktop tools for renaming movies, TV shows, and music using TMDB metadata — available open source, as a free demo, or as a paid app for Windows and macOS.
Project Details
A suite of desktop apps for renaming movies, TV shows, and music using TMDB metadata. Available free, open source, or as a paid one-time purchase — with native installers for Windows and macOS.
WINTER 2024 - CURRENT
Commercial Product
PLATFORM
Desktop (Windows/macOS)
- PYTHON
- TKINTER
- TMDB API
- PYTEST
- GITHUB ACTIONS
- PYINSTALLER
- DOCKER
- NEXT.JS
- STRIPE
- REDIS
- VERCEL
- CI/CD
About
Desktop apps built with Python and tkinter, backed by a Next.js marketing site, Stripe payments, and a custom VPS for delivery infrastructure.
Movie Renamer Ultimate is live and shipping. TV Show Renamer and Music Renamer are in active development — all three share the same distribution, payment, and delivery infrastructure.
Tools & Technologies
- Python 3.12+ with tkinter for the desktop UI
- TMDB API for movie metadata retrieval and fallback search
- PyInstaller for cross-platform executable builds
- Next.js 15 + Vercel for the marketing site and payment flow
3-Tier Distribution Model
Tier 1: Open Source
- • Core rename functionality
- • Auto-syncs to public GitHub repo
- • MIT License
- • Reaches technical users
Tier 2: Free Demo
- • Full features, 5 renames/day limit
- • DailyLimitManager with JSON counter
- • Direct downloads (no signup)
- • Drives conversions to paid
Tier 3: Paid ($19.99)
- • Unlimited renames
- • Stripe checkout integration
- • Token-based downloads (7-day expiry)
- • Automated email delivery
Key Features
- 3-Tier Distribution: Open source on GitHub, free demo (5 renames/day), and paid version ($19.99) with unlimited renames.
- Smart File Renaming: Parses complex filenames with quality markers, Roman numerals, and release groups — TMDB API integration with fallback strategies.
- Payment Integration: Stripe checkout with token-based downloads (7-day expiry) and automated email delivery via Resend.
- Cross-Platform: Ships native Windows installer (.exe) and macOS disk image (.dmg) built and released automatically on every update.
- Privacy-Respecting Demo: Daily limit enforced locally — no account required, no data collected.
- Growing Suite: Movie Renamer is live. TV Show Renamer and Music Renamer are in active development on the same infrastructure.
Technical Challenges & Solutions
Challenge: Cross-Platform File Rename Behavior
Solution: os.rename() behaves differently across Windows and Linux. Solved by normalising error handling to accept both OSError and FileExistsError, keeping behaviour consistent on all target platforms.
Challenge: Demo Version Daily Limit Tracking
Solution: Built a DailyLimitManager that stores a JSON counter in the user's home directory — no account or network call required. Resets automatically at midnight.
Challenge: Antivirus False Positives
Solution: PyInstaller bundles can trigger AV heuristics. Switching to --noupx brought the VirusTotal detection rate to 69/71 clean — acceptable for a commercial release.
Challenge: Zero-Downtime Delivery Infrastructure
Solution: VPS runs nginx-proxy with automatic Let's Encrypt SSL. New builds are deployed over SSH and the download links update without any manual steps or service interruption.
Project Stats
88/88
Tests Passing
97%
Test Coverage
3
Distribution Tiers
2
Build Platforms
6
CI/CD Jobs
3
Supported Apps
69/71
VirusTotal Score
$19.99
Price Point
Application Screenshots
