A cross-platform desktop application for organizing, tagging, and managing WAV audio files with Universal Category System (UCS) support, featuring advanced waveform editing and audio splitting capabilities.
- Pre-loaded UCS category catalog for audio categorization
- Drag-and-drop files directly onto categories for instant organization
- Intelligent file naming with automatic numbering (e.g.,
AMB_Room_01.wav) - Automatic folder structure based on category hierarchy
- Fuzzy search across filenames, tags, categories, and metadata
- Filter by category or view untagged files
- Quick "JUST SPLIT" filter surfaces freshly generated segments for rapid QC
- Multi-select support for batch operations
- Custom naming with automatic conflict resolution
- Free-form text tags
- UCS category assignments
- Metadata fields: Author, Copyright, Rating
- Bulk editing for multiple files simultaneously
- Visual waveform editing with playback controls
- Segment-based audio splitting and trimming
- Real-time preview with zoom and pan controls
- Export individual segments with automatic naming
- Non-destructive editing workflow
- Real-time waveform visualization with dynamic color-coding based on RMS levels
- Waveform editor for splitting and trimming audio
- Smooth animations and polished drag-and-drop interactions
- Responsive file list with keyboard navigation (Arrow keys, Ctrl+A)
- Dark theme optimized for long sessions
Download the latest AudioSort Setup.exe from the Releases page and run the installer.
# Download from Releases page
chmod +x AudioSort-*.AppImage
./AudioSort-*.AppImagesudo dpkg -i audio-sort_*.deb
sudo apt-get install -f # Install dependencies if neededsudo dnf install ./audio-sort-*.rpm- Node.js 20+
- npm or pnpm
# Clone the repository
git clone https://github.com/litruv/AudioSort/
cd AudioSort
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Create Windows installer
npm run dist:win- Launch AudioSort
- Set your library path via File > Settings (or Ctrl+,)
- AudioSort will automatically scan and index your WAV files
- Select one or multiple files
- Assign categories using the Tag Editor
- Click "Organize" to automatically move and rename files based on their categories
- Files are organized into
CATEGORY/SUBCATEGORY/folders with smart naming
↑/↓- Navigate file listCtrl+A- Select all visible filesCtrl+,- Open settingsDouble-click- Play audio file
Ctrl+Click- Toggle individual file selectionShift+Click- Select range- Edit tags, categories, and metadata for all selected files at once
AudioSort/
├── src/
│ ├── main/ # Electron main process
│ │ ├── services/ # Core services (Database, Library, Search, Tags)
│ │ ├── MainApp.ts # Application coordinator
│ │ └── index.ts # Entry point
│ ├── renderer/ # React frontend
│ │ └── src/
│ │ ├── components/ # UI components
│ │ ├── stores/ # State management
│ │ └── hooks/ # Custom React hooks
│ ├── preload/ # Electron preload scripts
│ └── shared/ # Shared types and IPC definitions
├── data/
│ └── UCS.csv # Universal Category System catalog
└── repoimages/ # Documentation assets
npm run dev # Start development server with hot reload
npm run build # Build renderer and main process
npm run lint # Type-check with TypeScript
npm run pack # Package without installer
npm run dist # Create distributable
npm run dist:win # Create Windows installer
npm run dist:linux # Create Linux packages (AppImage, deb, rpm)For detailed information about building and distributing on Linux, see LINUX_BUILD.md.
Supported formats:
- AppImage - Universal, runs on any distribution
- DEB - Debian, Ubuntu, and derivatives
- RPM - Fedora, RHEL, CentOS, openSUSE
User data is stored in:
- Windows:
%APPDATA%/AudioSort/ - Linux:
~/.config/AudioSort/