FRKB

Rapid Audio Organization Tool

English · 简体中文

FRKB

How to Use

1. Download from the website or the Releases:
   • Website: https://coderDJing.github.io/FRKB_Rapid-Audio-Organization-Tool/
   • Or go to Releases and pick your platform (Windows/macOS)
2. Run the installer to install on your computer.
3. Launch FRKB from the desktop shortcut.

Project Background

As a DJ, I frequently need to organize large numbers of music files. However, existing audio file management software often falls short. Many require excessive mouse operations, leading to shoulder and neck pain. Others have poorly designed shortcuts that do not conform to ergonomic principles. Additionally, some only manage file references, leaving the actual file manager cluttered and disorganized. Furthermore, I often end up downloading duplicate songs, which wastes time during the selection process. Therefore, I decided to develop a more user-friendly software solution to address these issues.The ultimate goal of this project is to incorporate AI models that will learn users' classification behavior patterns and automatically categorize songs into libraries, which will save me God knows how much time.

Introduction

FRKB is a cross-platform desktop audio workflow tool designed for audio professionals such as DJs. It combines rapid library organization, fingerprint deduplication, waveform-driven preview, auto-recording, stem separation, Pioneer USB library support, global search, and standalone conversion in one desktop app for Windows and macOS.

System Requirements

• Windows 10 or later (x64)
• macOS 12 or later

Core Features

• Portable: Easily transfer the database to mobile devices for on-the-go use.

• Song Deduplication: Identify and exclude duplicate tracks using content fingerprints (content hash / file hash modes; content hash ignores cover art, title, artist, etc.), with prompts during import to keep your library clean and efficient.

• Playlist Fingerprint Deduplication: One-click analysis on a playlist and move duplicates to the recycle bin.

• Ergonomic Shortcuts: Ergonomically designed shortcuts that allow most operations to be performed with the left hand, making the organization process smoother and more efficient.

• Global Shortcuts: Playback controls even when minimized, plus a customizable focus/minimize toggle shortcut.

• Selectable Playback Range: Often, you only need to listen to a specific part of an audio track for screening. This feature allows you to set a start and end point for playback.

• Output Device Selection: Choose a specific output device or follow the system default.

• Direct File Management: When adding tracks, FRKB directly manages the audio files themselves, ensuring that the organization results are immediately reflected in the computer's folders, achieving a "what you see is what you get" effect.

• Filter/Curated Dual-Library Flow: Fast triage and layered organization that matches DJ workflows.

• Drag-and-Drop Import & Move: Drag files/folders to import, drag tracks between playlists, and hold Ctrl/Option to drag out copies to Explorer/Finder.

• External Track Playback: Open external audio files for temporary playback without importing them.

• Track Export: Export to a folder and optionally delete tracks after export.

• Multiple Waveform Visualizations: Offers SoundCloud-style waveform, fine-grained waveform, and RGB three-band energy view to spot drops and phrasing instantly.

• Waveform Preview Column: Shows cached waveform previews directly in the song list for fast scanning.

• BPM Analysis & Tap Tempo: Displays BPM information. Left-click the BPM to tap tempo (calculated to 1 decimal place). When the BPM is manually tapped, it is highlighted in #0078d4. Right-click to restore the system-analyzed BPM. Tooltip: "Tap beat (LMB) / Reset (RMB)".

• Key Analysis & Display: Supports Classic (C#m) and Camelot (1A/1B) display styles.

• Recycle Bin: Safely recover deleted tracks and restore them to their original playlists.

• Cloud Sync (fingerprints): Bidirectional sync of local track fingerprints (SHA256) with the cloud, including diff analysis, paginated pulls, and batched uploads, with quota and rate limiting (up to 10 sync starts within 5 minutes). Entry: system tray → Cloud Sync.

• Internationalization (i18n): Built-in Chinese (zh-CN) and English (en-US) language packs.

• Save Cover Image: Right-click the enlarged cover to save the image locally.

• Metadata Editing & Online Fill: Edit tags and cover art with MusicBrainz criteria search and AcoustID fingerprint matching, plus batch auto-fill for track info.

• Song Filtering: Filter by title, artist, album, duration, format, BPM, and more, with optional persistence after restart.

• Wide Format Playback & Conversion: Built-in FFmpeg pipeline plays instantly, supports standalone conversion workflows, and batch-converts 20+ mainstream and pro audio formats.

• Mixtape Timeline Editing: Dedicated auto-recording workspace with a dual-track timeline, beat-grid editing, first-downbeat analysis, metronome tools, preview sync, gain/BPM envelopes, mute segments, undo support, and timeline-accurate export.

• Stem Runtime & Separation: Stem mode, managed runtimes, separation cache management, ONNX fast separation, DirectML/XPU acceleration, and on-demand runtime downloads for auto-recording workflows.

• Pioneer USB Library Support: Read more Pioneer USB library variants, including legacy Device Library and OneLibrary entries, with preview waveform caching, multi-drive recognition, playback, and guarded operations.

• Global Track Search: Search songs across the app and jump back to the matching location with clearer and more stable locate feedback.

• Idle Background Scheduling: Unified idle-task scheduling and throttling keep background analysis predictable while reducing contention with foreground work.

  Format	Scan/Playback	Conversion
  MP3	✅	✅
  WAV	✅	✅
  FLAC	✅	✅
  AIF	✅	✅
  AIFF	✅	✅
  OGG	✅	✅
  OPUS	✅	✅
  AAC	✅	✅
  M4A	✅	✅
  MP4	✅	✅
  WMA	✅	✅
  AC3	✅	✅
  DTS	✅	✅
  MKA	✅	✅
  WEBM	✅	✅
  APE	✅	✅
  TAK	✅	✅
  TTA	✅	✅
  WV	✅	✅

Contributions

Contributions of all kinds are welcome! Whether reporting issues, suggesting features, or contributing code, feel free to open an issue or submit a pull request.

License

FRKB follows the GNU General Public License v2.0 or later (GPL-2.0-or-later).

Development

Compile Rust

pnpm add -g @napi-rs/cli
cd ./rust_package
napi build --platform --release

Installing Dependencies

cd ..
pnpm install

Development Mode

pnpm run dev

Building

# For windows
$ pnpm build:win

# For macOS
$ pnpm build:mac

Backlog

backlog.md

Cloud Sync Backend Project

• FRKB-API (cloud sync server): https://github.com/coderDJing/FRKB-API