Insert a disc. It lands in your media library.
v2.1.0 - Faster, correct DVD rips (including multi-version discs) and in-app MakeMKV updates
π€ AI Development Experiment: This entire application was built using AI assistance (Warp 2.0 + Claude Code) by someone with zero Swift experience and an Art Degree. Read the full experiment documentation π¨βπ¨βπ»
Spindle (formerly AutoRip2MKV) is a native macOS app that imports discs into your media library automatically. It rips DVDs and Blu-rays to MKV and files them into Movies and TV Shows folders with each TV episode named, and rips music CDs to tagged FLAC in your Music folder. Photo discs are filed by date (or added to Apple Photos), home-made DVDs go to Home Videos, and other data discs are copied as they are. Importing from folders, USB drives and Apple Photos is next (see the Roadmap). DVDs rip with no setup using open-source libdvdcss; Blu-ray decryption is handled by MakeMKV (see Blu-ray support).
- Hands-free ripping - Insert a disc and walk away: auto-rip on insert, auto-eject when the read finishes, skip discs already ripped
- DVD CSS Decryption - Open-source libdvdcss for Content Scramble System decryption
- Fast DVD reads - Titles are read at full drive speed to local storage, the disc ejects, and encoding runs in the background while the next disc reads
- Multi-version discs - Follows DVD seamless branching, so discs with several cuts of the movie rip as one clean title
- Damaged discs - Unreadable sectors are retried, then skipped (up to a limit) instead of failing the rip
- TV seasons - Every episode ripped (not the "play all" title), named from TMDB or OMDb, filed as
TV Shows/Show (Year)/Season 01/Show (Year) - S01E05 - Title.mkv; disc 2 picks up where disc 1 stopped - Music CDs - Identified on MusicBrainz, ripped to FLAC with tags and cover art, filed as
Music/Artist/Album (Year)/01 - Title.flac - Photo discs - Each photo copied and verified, filed by the date it was taken in your Photos folder's own layout (decade/year/month folders, or
Photos/2004/2004-07-14/) and/or added to Apple Photos, photos already anywhere in the library skipped - Home videos and data discs - Camcorder and recorder DVDs ripped into Home Videos, named by date; other data discs copied as they are into Imported Discs
- Blu-ray Support - Via MakeMKV (auto-detected once installed); the app helps you install it, and can update an expired build for you
- DVDs need nothing extra - No MakeMKV, key database, or other tools required for DVD ripping
- All tracks captured - Every audio and subtitle track, tagged with languages from the disc
- Auto-deinterlace - Interlaced (NTSC) sources are deinterlaced automatically
- Plex-ready -
Movie (Year)naming, with finished rips sorted into separate Movies and TV Shows library folders - Main movie or everything - Rip only the main feature (default), or bonus features too
- FFmpeg set up for you - Downloaded on first launch if it isn't already installed
- Hardware Acceleration - Optional VideoToolbox H.264/HEVC encoding
- Stays awake - The Mac won't idle-sleep in the middle of a rip
- Automatic Drive Detection - Smart optical drive detection and selection
- Native macOS interface built with Swift and AppKit; persistent settings
- Progress tracking and logging with real-time updates
- Automatic DVD/Blu-ray structure analysis and title detection
- Chapter preservation and metadata inclusion
- Multiple video/audio codec support (H.264, H.265, AV1, AAC, AC3, DTS, FLAC)
- Configurable quality settings
- π€ 100% AI-Generated: ~24,000 lines of Swift (app and tests) created entirely by AI
β¨ Just download and run - no building required!
- Download the latest release from GitHub Releases
- Open the DMG file and drag Spindle to Applications
- Launch it. The app is signed and notarized by Apple, so it opens normally.
- FFmpeg: on first launch the app downloads FFmpeg if it isn't already installed.
For hardware-accelerated encoding on Apple Silicon, install a native build with
brew install ffmpeg; the app finds it automatically. - Start ripping! DVDs need nothing else. For Blu-ray, see Blu-ray support.
π Need help with installation? See the detailed Installation Guide for step-by-step instructions to handle macOS security restrictions.
Requirements:
- macOS 13.0 or later
- Swift 5.8+ and Xcode Command Line Tools
- Homebrew
libdvdcssandlibaacs:brew install libdvdcss libaacs
Steps:
git clone https://github.com/gmoyle/Spindle.git
cd Spindle
swift build && swift run./deploy.sh builds a release copy into ~/Applications and launches it.
When you launch Spindle for the first time, the application will:
- Find FFmpeg - Use an installed FFmpeg (Homebrew's is preferred), or download one
- Hardware Detection - Test if your Mac supports VideoToolbox hardware acceleration
- Acceleration Dialog - If supported, offer to enable hardware acceleration for faster processing
- Save Preferences - Your choice is remembered for future sessions
With the default settings, ripping is hands-free β insert a disc and walk away:
- Launch Spindle from Applications (leave it running).
- Insert a DVD/Blu-ray. The app detects it, identifies the movie, and starts ripping automatically.
- The disc ejects when the read finishes; encoding continues in the background.
- Insert the next disc. Repeat for as many as you like.
The main window shows the queue and live progress (disc-read size, then encode percentage). The app handles everything automatically:
- β FFmpeg found or downloaded automatically
- β Drive detection, disc identification (TMDB or OMDb), and CSS/AACS decryption
- β Auto-deinterlace of interlaced (NTSC) sources
- β All audio and subtitle tracks captured, with language labels
- β
Conversion to MKV, with Plex-style
Movie (Year)naming - β Automatic Movies / TV Shows routing into separate Plex library folders
- β Auto-eject when the read completes; already-ripped discs are skipped (a disc whose rip folder you deleted is ripped again)
- β Optional hardware acceleration (VideoToolbox)
- β Cancel a rip in progress from the main window
Overrides: a disc already ripped with the current settings is skipped and ejected. Change any rip setting, hold β₯ Option while inserting, or click Start Ripping to force a re-rip. Auto-rip, auto-eject, and skip-already-ripped each have a checkbox in the main window. Films and TV seasons are ripped into the Rips Folder (Settings β Output & Routing; it defaults to your Plex movie library if one is found), then routed. The main window lists every disc in a drive and every rip, each with its own Cancel button.
Rip settings live in Settings⦠(Output & Routing, Encoding, Advanced). See the Settings Guide for each option.
Rips are named Movie (Year)/Movie (Year).mkv. With content routing on
(Settings β Output & Routing), each finished rip is classified as a movie or a TV
season and moved into your Movies or TV Shows folder; rips the app isn't sure about
wait under Review Rips. The library folders can be on a NAS: files are copied
under a hidden name and renamed when complete, so Plex never sees a partial file.
Ripping the same disc again replaces its files in place rather than creating a
second folder.
Encoding always happens in a local cache folder; only finished files are moved to your output and library folders, so an iCloud- or network-synced folder never holds a half-written file.
DVDs rip with no setup. Blu-ray discs use AACS/BD+ copy protection that Spindle cannot legitimately decrypt on its own, so Blu-ray ripping is handled by MakeMKV (free during its beta), which manages decryption with its own keys. Spindle ships no decryption keys.
- On first launch, the app offers to help you install MakeMKV. You can also install it any time from makemkv.com/download.
- MakeMKV's free beta builds expire. When that happens the app tells you, and Download & Install fetches the current version from makemkv.com and replaces the old one (or you can enter a registration key).
- Once MakeMKV is installed, Spindle detects and uses it automatically β insert a Blu-ray and it rips just like a DVD, with the same Plex-style naming and output location.
- The "Use MakeMKV for Blu-ray" setting (Detailed Settings, on by default)
controls this. Advanced users can instead supply a libaacs key database at
~/.config/aacs/KEYDB.cfgto use the built-in libaacs path. - DVDs use the built-in reader by default. Also use MakeMKV for DVDs switches them to MakeMKV too; it's slower, because MakeMKV scans the whole disc first.
Note: MakeMKV's Homebrew cask is deprecated (it fails macOS Gatekeeper). Install from makemkv.com, or let the app do it.
The application expects a mounted DVD with the standard VIDEO_TS structure:
/Volumes/YOUR_DVD/
βββ VIDEO_TS/
βββ VIDEO_TS.IFO
βββ VTS_01_0.IFO
βββ VTS_01_1.VOB
βββ VTS_01_2.VOB
βββ ...
This project is built using Swift Package Manager and native macOS frameworks:
- Swift: Primary programming language
- AppKit: Native macOS UI framework
- Cocoa: macOS development framework
Key files in Sources/Spindle/ (see CLAUDE.md for the full architecture):
| File | Role |
|---|---|
DriveDetector.swift |
Watches for disc mounts and unmounts |
MainViewController*.swift |
Main window, skip-already-ripped check, MakeMKV dialogs |
ConversionQueue.swift |
Job queue: disc read, then background encode |
MediaRipper*.swift |
Per-format importers (DVD, Blu-ray, HD DVD, audio CD, photo and data discs) and FFmpeg encoding |
PhotoImport.swift, HomeVideo.swift, LibraryFiles.swift |
Photo dates, duplicates and Apple Photos; home-video naming; verified copies and safe moves into libraries |
DVDStructureParser.swift, DVDDecryptor.swift |
DVD IFO parsing and libdvdcss reads |
MakeMKVBackend.swift, MakeMKVInstaller.swift |
Blu-ray via makemkvcon, MakeMKV install/update |
ContentRouter.swift, ContentTypeClassifier.swift |
Movies / TV Shows routing |
RipHistoryStore.swift, DiscIdentity.swift |
Which discs have been ripped |
Tests are in Tests/SpindleTests/.
Note: Most users should download the pre-built release instead of building from source.
swift build && swift test # build and run the tests
./deploy.sh # release build to ~/Applications, signed, launched- Installation Guide - Detailed setup instructions for macOS
- User Guide - How to use the app
- Settings Guide - Every setting explained
- Decryption Libraries - Integration details for libdvdcss and libaacs
- Changelog - Release history and version changes
- Roadmap - Project timeline and planned features
See our comprehensive Roadmap for planned features, enhancements, and long-term project goals including:
- Enhanced 4K Support: Ultra HD Blu-ray detection and processing
- Hands-free automation: auto-rip on insert, auto-eject, skip already-ripped discs
- Professional Features: Metadata management and enterprise tools
- Cross-Platform Expansion: Linux and Windows support evaluation
- AI Development Evolution: Next-generation code generation experiments
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
This application uses open-source decryption libraries (libdvdcss and libaacs) from VideoLAN for production-ready DVD and Blu-ray decryption:
DVD Decryption (libdvdcss):
- CSS authentication and key management
- Automatic title key retrieval
- Sector-by-sector decryption during read operations
- Battle-tested implementation from VLC Media Player
Blu-ray Decryption (libaacs):
- AACS authentication and processing
- 6144-byte unit decryption
- KEYDB.cfg integration for key management
- Production-ready Blu-ray support
The application parses the DVD structure natively:
- VMGI (Video Manager Information) parsing
- VTS (Video Title Set) analysis
- Program Chain (PGC) information extraction
- Chapter and cell information parsing
- Duration and metadata extraction
- Seamless branching: interleaved cells are followed VOBU by VOBU through each nav pack's next-VOBU pointer, the way a DVD player does
After decryption, the application uses bundled FFmpeg for video conversion:
- FFmpeg is found on the system (Homebrew preferred) or downloaded on first launch
- Support for multiple codecs (H.264, H.265, VP9, AV1), with VideoToolbox for H.264/HEVC
- Audio codec options (AAC, AC3, DTS, FLAC)
- Chapter preservation
- Metadata inclusion
- Quality settings (CRF-based)
This software is intended for legitimate backup purposes of DVDs you legally own. Users are responsible for complying with all applicable laws regarding DVD copying and CSS circumvention in their jurisdiction.
This project represents a groundbreaking experiment in AI-powered software development:
- Developer: Art degree, zero Swift experience
- Code written by human: 0 lines β 100% AI-generated
- Development method: 100% AI-assisted (Warp 2.0, then Claude Code)
- Codebase: ~24,000 lines of Swift across the app and tests
- Latest release: v2.1.0 - Faster, correct DVD rips and in-app MakeMKV updates (Nov 2026)
- Features: DVD/Blu-ray ripping, libdvdcss/libaacs decryption, hands-free auto-rip, all-track capture, Plex-ready output
π Read the full experiment documentation to see how AI democratizes software development.
"From art degree to Swift developer in one conversation" π¨βπ¨βπ»
- Warp 2.0 Agent Mode for making this experiment possible
- Susanne Moyle for recommending the nostalgic floppy disk design element
- The Swift and macOS development communities
- FFmpeg project for video conversion capabilities
- DVD Forum specifications for DVD structure documentation
|
Main Icon 512Γ512 Application Icon |
Simple Icon 128Γ128 Favicon & Small UI |
Horizontal Logo 400Γ120 Documentation & Web |
Professional macOS-style icon featuring a large DVD disc with bright orange floppy disk overlay,
representing the classic-to-digital conversion process. Floppy disk design recommended by
Susanne Moyle for nostalgic throwback appeal, with anatomically correct vertical access window.
