FlipChanger is an open-source application for the Flipper Zero that helps users track physical CDs loaded into a CD changer system (3-200 discs). Store metadata like artist, album, and track listings directly on your Flipper Zero, similar to MP3 ID3 tags.
- Slot Management: Track which CDs are in which slots (1-200)
- Metadata Storage: Store artist, album, year, genre, and track listings for each CD
- View & Browse: Navigate your collection easily on the Flipper Zero display
- Add/Edit CDs: Manage your collection directly from the device
- Data Persistence: All data saved to SD card, survives reboots
- Multi-Changer: Multiple CD changers (Name, Location, Slots); switch at top menu; per-Changer data
- IR Remote Integration (planned): Control your CD changer using Flipper Zero's infrared capabilities
✅ Active Development - Core features implemented and working! App builds, runs, and persists data successfully on Flipper Zero.
- ✅ Enhanced Fields: Disc Number, Album Artist (for compilations)
- ✅ Multi-Changer: Changers (Name, Location, Slots); select at top menu; header shows Changer name; Add/Edit/Delete
- ✅ Splash Screen: Brief FlipChanger logo on launch
- ✅ Main Menu: 6 options (View Slots, Add CD, Settings, Statistics, Changers, Help); scrollable (5 visible)
- ✅ Core UI: Slot browser, slot details view; per-Changer slots database
- ✅ Navigation: Wrap-around with scroll, long-press skip by 10; Changer switch persists
- ✅ Memory Optimization: SD card-based caching; deferred load/save to avoid stack overflow
- ✅ Add/Edit Interface: Character input; track management (title, duration)
- ✅ Settings/Statistics: Slot count per Changer; statistics
- 📋 Planned: IR integration
v1.2.0 testing gate: On-device testing is needed before submission. See TESTING_CHECKLIST.md. Contributors with a Flipper Zero can build, deploy (ufbt launch), and run through the checklist.
- Product Vision Document - Complete project vision and goals
- Changers Design - Multi-Changer architecture
- Changelog - Version history
- Development Setup Guide - Flipper Zero development research
- Quick Start Checklist - Development checklist
- Progress Report - Current development status and achievements
- Core FlipChanger application
- Slot management (1-200 slots)
- CD metadata tracking
- Quick start:
cd flipchanger-app ufbt build APPID=flipchanger # Build the app ufbt launch APPID=flipchanger # Deploy and run
- See flipchanger-app/README.md for details
- Status: ✅ Working! App successfully deployed and running on device. Memory optimized for Flipper Zero constraints.
- Simple test app to verify uFBT setup
- See hello-world-ufbt/README.md
- JavaScript SDK test app (requires Node.js)
- See hello-world-app/README.md
Coming Soon - Once published to the Flipper Zero app store, installation instructions will be provided here.
- Flipper Zero device
- Flipper Zero development environment (see official docs)
- SD card for data storage
Prerequisites:
- uFBT installed:
pipx install ufbt(✅ Done!) - Flipper Zero device with USB cable
- SD card inserted (for data storage)
Build and Deploy:
cd flipchanger-app
ufbt build APPID=flipchanger # Build the app
ufbt launch APPID=flipchanger # Deploy and run on deviceFile Location:
- Built app:
/Users/gilbertroberts/.ufbt/build/flipchanger.fap - Installed to device:
/ext/apps/Tools/flipchanger.fap
Contributions are welcome! This is a learning project, so whether you're a beginner or experienced developer, your input is valuable.
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
- Flipper Zero community
- All contributors and future contributors
Note: This is an educational project for learning Flipper Zero application development and open-source practices.