{"id":29127909,"url":"https://github.com/alejandrojimbui/sample-browser","last_synced_at":"2025-06-30T01:02:09.104Z","repository":{"id":290245275,"uuid":"973778615","full_name":"AlejandroJIMBUI/Sample-Browser","owner":"AlejandroJIMBUI","description":"PyQt6-Powered Audio Sample Browser with Multi-Format Compatibility and Theme Customization","archived":false,"fork":false,"pushed_at":"2025-06-18T12:39:39.000Z","size":2252,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-18T13:43:17.726Z","etag":null,"topics":["audio-management","desktop-application","file-explorer","gui","pyqt6","python","qt","themes"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AlejandroJIMBUI.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-27T18:07:25.000Z","updated_at":"2025-06-18T12:39:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"6dc887c5-aefe-47c8-9ca3-50149f7f6060","html_url":"https://github.com/AlejandroJIMBUI/Sample-Browser","commit_stats":null,"previous_names":["alejandrojimbui/sample-browser"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/AlejandroJIMBUI/Sample-Browser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlejandroJIMBUI%2FSample-Browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlejandroJIMBUI%2FSample-Browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlejandroJIMBUI%2FSample-Browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlejandroJIMBUI%2FSample-Browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlejandroJIMBUI","download_url":"https://codeload.github.com/AlejandroJIMBUI/Sample-Browser/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlejandroJIMBUI%2FSample-Browser/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262690426,"owners_count":23349168,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio-management","desktop-application","file-explorer","gui","pyqt6","python","qt","themes"],"created_at":"2025-06-30T01:02:06.292Z","updated_at":"2025-06-30T01:02:09.035Z","avatar_url":"https://github.com/AlejandroJIMBUI.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sample-Browser\n\n**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.\n\n---\n\n# Characteristics\n\n- **File Explorer**: Navigate your file system using tree and list views.\n- **Audio Preview**: Play supported audio files directly within the application.\n- **Multi-Format Support**: Compatible with `.wav`, `.mp3`, `.aif`, and `.flac` formats.\n- **Customizable Interface**: Switch visual themes and save settings such as the last opened directory, window geometry, and panel states.\n- **Drag and Drop**: Supports dragging files directly from the file list.\n- **Theme Loader**: Customize the app's appearance with visual styles.\n\n---\n\n# System Requirements\n\n- **Operating System**: Windows 10/11 (64-bit)\n- **Python**: Version 3.9 or higher\n- **Dependencies**:\n  - PyQt6\n\n---\n\n# Installation\n\n### Option 1: Executable (Recommended)\n1. Download the installer from [https://github.com/AlejandroJIMBUI/Sample-Browser/releases/tag/v1.0.0].\n2. Run the installer and follow the on-screen instructions.\n3. Once installed, launch the application from the Start menu.\n\n### Option 2: Source Code Installation\n1. Clone this repository using the following command:\n   ```bash\n   git clone https://github.com/AlejandroJIMBU/Sample-Browser.git\n   cd sample-browser\n   ```\n2. Create a Virtual Environment and Install Dependencies:\n   ```bash\n   python -m venv venv\n   venv\\Scripts\\activate\n   pip install -r requirements.txt\n   ```\n3. Run the Application:\n   ```bash\n   python src/main.py\n   ```\n\n---\n\n# Images\n\n### Theme: dark\n![Theme: dark](img/sp_screenshot_1.png)\n\n### Theme: Light\n![Theme: oddball](img/sp_screenshot_2.png)\n\nFuture releases will introduce new themes and additional features\n\n---\n\n# Usage\n\n1. Upon launching the application, select a directory using the built-in file explorer.\n2. Preview audio files by clicking on them.\n3. Customize your experience through the settings menu to:\n   - Switch visual themes\n   - Adjust application preferences\n4. Drag and drop files directly from the file list to external applications.\n\n---\n\n# Development\n\n### Setting Up the Development Environment\n1. Install Development Dependencies\n   ```bash\n   pip install -r requirements.txt\n   ```\n2. Running Unit Tests\n   ```bash\n   pytest\n   ```\n\n### Building the Application\n**Generating Executables with PyInstaller**:\n```bash\npyinstaller --onefile --windowed main.py\n```\n\n### Key Build Options:\n- `--onefile`: Single executable output\n- `--windowed`: Prevent console window display (GUI apps)\n- `--name`: Set output application name\n- `--icon`: Specify application icon\n- `--add-data`: Include additional resource files\n\n### Post-Build Verification:\n- Check generated files in /dist directory\n- Test executable functionality\n- Validate resource inclusion\n\n---\n\n# Downloads\n\n**Latest Release**: [https://github.com/AlejandroJIMBUI/Sample-Browser/releases/tag/v1.0.0]\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falejandrojimbui%2Fsample-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falejandrojimbui%2Fsample-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falejandrojimbui%2Fsample-browser/lists"}