Sample Browser

Sample Browser is a Python-based desktop application built with PyQt6, designed for music producers working across multiple DAWs. It enables efficient audio file browsing, previewing, and management, featuring an intuitive and customizable interface with support for visual themes and persistent settings.

---

Characteristics

• File Explorer: Navigate your file system using tree and list views.
• Audio Preview: Play supported audio files directly within the application.
• Multi-Format Support:Supports a wide range of audio formats (.wav, .mp3, .aif, .ogg, .flac) as well as project/plugin formats (.mid, .amxd, .adg, .fst, .fxp, .fxb).
• Customizable Interface: Switch visual themes and save settings such as the last opened directory, window geometry, and panel states.
• Drag and Drop: Supports dragging files directly from the file list.
• Theme Loader: Customize the app's appearance with visual styles.

---

System Requirements

• Operating System: Windows 10/11 (64-bit)
• Python: Version 3.9 or higher
• Dependencies:
  • PyQt6

Note

I'm still working on the MAC and Linux versions.

---

Installation

Option 1: Executable (Recommended)

1. Download the installer from Sample Browser v2.0.0.
2. Run the installer and follow the on-screen instructions.
3. Once installed, launch the application from the Start menu.

Option 2: Source Code Installation

1. Clone this repository using the following command:

   git clone https://github.com/AlejandroJIMBU/Sample-Browser.git
   cd sample-browser

2. Create a Virtual Environment and Install Dependencies:

   python -m venv venv
   venv\Scripts\activate
   pip install -r requirements.txt

3. Run the Application:

   python src/main.py

---

interface screenshoots

Images

Theme: dark

Theme: softBlue

Theme: 1bitMonitorGlow

Theme: everglowDiamond

Future releases will introduce new themes and additional features

---

Usage

1. Upon launching the application, select a directory using the built-in file explorer.
2. Preview audio files by clicking on them.
3. Customize your experience through the settings menu to:
   • Switch visual themes
4. Drag and drop files directly from the file list to external applications.

---

Development

Setting Up the Development Environment

• Install Development Dependencies

  pip install -r requirements.txt

Building the Application

• Generating Executables with PyInstaller

  pyinstaller --onefile --windowed main.py

Key Build Options:

• --onefile: Single executable output
• --windowed: Prevent console window display (GUI apps)
• --name: Set output application name
• --icon: Specify application icon
• --add-data: Include additional resource files

Post-Build Verification:

• Check generated files in /dist directory
• Test executable functionality
• Validate resource inclusion

---

Downloads

Latest Release: Sample Browser Ver 2.0.0