{"id":22973122,"url":"https://github.com/justlep/sample-commander","last_synced_at":"2025-08-08T02:04:04.833Z","repository":{"id":4803861,"uuid":"189567776","full_name":"justlep/sample-commander","owner":"justlep","description":"A free spectrogram-assisted file browser \u0026 player for audio recordings","archived":false,"fork":false,"pushed_at":"2024-01-09T17:35:02.000Z","size":7842,"stargazers_count":10,"open_issues_count":13,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-19T10:55:59.394Z","etag":null,"topics":["audio-analysis","audio-applications","audio-files","browser","converter","desktop-app","electron","ffmpeg","fieldrecording","mp3","player","wave"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justlep.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}},"created_at":"2019-05-31T09:31:45.000Z","updated_at":"2024-11-13T12:59:12.000Z","dependencies_parsed_at":"2024-12-14T23:39:45.261Z","dependency_job_id":null,"html_url":"https://github.com/justlep/sample-commander","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/justlep/sample-commander","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justlep%2Fsample-commander","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justlep%2Fsample-commander/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justlep%2Fsample-commander/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justlep%2Fsample-commander/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justlep","download_url":"https://codeload.github.com/justlep/sample-commander/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justlep%2Fsample-commander/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269351910,"owners_count":24402678,"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","status":"online","status_checked_at":"2025-08-08T02:00:09.200Z","response_time":72,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-analysis","audio-applications","audio-files","browser","converter","desktop-app","electron","ffmpeg","fieldrecording","mp3","player","wave"],"created_at":"2024-12-14T23:39:41.344Z","updated_at":"2025-08-08T02:04:04.804Z","avatar_url":"https://github.com/justlep.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LeP's Sample Commander \n\n\u003ca href=\"https://www.gnu.org/licenses/gpl-3.0\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-GPLv3-blue.svg\" alt=\"License: GNU GPL v3\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/justlep/sample-commander/releases\"\u003e\u003cimg alt=\"Latest GitHub release\" src=\"https://img.shields.io/github/v/release/justlep/sample-commander.svg\"\u003e\u003c/a\u003e\n[![Build Status](https://api.travis-ci.com/justlep/sample-commander.svg?branch=master)](https://app.travis-ci.com/github/justlep/sample-commander) \n\n\n![](https://samplecommander.justlep.net/img/2.0.0-main-spectrograms-enabled.png)\n\n[More Screenshots \u0026 Videos](https://github.com/justlep/sample-commander/blob/master/docs/screenshots.md)\n\n## Features:\n\n- **2-panel layout** with adjustable widths:\n    - `Source Panel` (left): listing audio files of a selected folder (+ subfolders if enabled)\n    - `Target Panel` (right): showing a directory tree of another folder, e.g. your sample collection location    \n       (can be hidden, leaving all screen space to the Source panel)\n- **Flame-style spectrograms**\\*\n    - **clickable** to set **playback position** (rightclick pauses playback)\n    - Frequency axis in **[Mel scale](https://en.wikipedia.org/wiki/Mel_scale)**, limited to 20.000 Hz (~3817 Mel)\n- Drag \u0026 Drop\n    - **Copy or move files by dragging** files from the Source Panel into Target Panel folders\n    - **Drag** audio files from the Source Panel **directly into external applications** (e.g. your DAW)\n- **Rename multiple files at once** using **patterns, counters, search/replace** (incl. regular expressions)\n- **Convert to MP3, AAC\\* or Wave** (MP3 in CBR or VBR)\n  - \\*AAC conversion via ffmpeg's native or Fraunhofer \"libfdk_aac\" codec\n  - `libfdk_aac` is normally not included; you need a special ffmpeg build like [this](https://www.reddit.com/user/VeritablePornocopium/comments/okw130/ffmpeg_with_libfdk_aac_for_windows_x64/)\n- Helpful **context menus per right-click**, allowing e.g. to\n    - show any file/folder in **Windows Explorer**\n    - show any file/folder in your **preferred file manager**\\*\\*  (like [Total Commander](https://www.ghisler.com/) ❤)\n    - open files in your **preferred audio editor**\\*\\* (like Izotope RX)\n    - open files in the **system-default application**\n- **Filter files by filename**\n- **Find unique or duplicate files** (even renamed copies):\n    - Display only files in the Source panel that exist in both the Source panel folder AND the Target panel folder\n    - Display only files in the Source panel that have NO identical copy in the currently selected Target folder\n    - configurable duplicate-check strategy: Quick mode vs. Full-Content scan \n- Fast **recall of folders** through lists for\n    - Recent Source panel folders\n    - Recent Target panel folders\n    - **Bookmarked folders**\n- Customizable **limits** for performance safety:\n    - limit the max. number of loaded/displayed directories and files\n    - limit the max. number of concurrently processed audio files\n\n_* requires FFmpeg binaries, see Installation_\n  \n_** configurable in Sample Commander's Settings dialog**_\n\n## System Requirements\nOnly `Windows 7` and `Windows 10` are currently supported.  \nOther OS may be added in the future.\n\n## Installation / Update\n1. Run the latest installer from the [Releases](https://github.com/justlep/sample-commander/releases) page \n   (`Sample Commander Setup 2.x.x.exe`).  \n   Sample Commander takes around 160 MB on your harddisk (excluding `FFmpeg` binaries).\n\n   (_Any previously installed 2.x version will be overwritten automatically._) \n\n2. After the **very first installation**, make sure you also download the free `FFmpeg` binaries for Windows. \n   Without `FFmpeg`, Sample Commander won't be able to generate spectrograms or show details about your audio files.\n\n### Setting up FFmpeg (once only)\n   \n1. Download a pre-built package (ZIP file) of `FFmpeg` binaries from a location below: \n    - **Recommended:** \n      https://ffmpeg.zeranoe.com/builds/win64/static/ffmpeg-4.1.3-win64-static.zip  \n      This is the  FFmpeg version I am using myself while running and developing Sample Commander.\n    - Alternatively: https://ffmpeg.zeranoe.com/builds/   \n      That page generously provides the latest prebuilt, ready-to-use FFmpeg packages.  \n      For use with Sample Commander, choose Version = `4.1.x`, Architecture = `Windows 64-bit`, Linking = `Static`. \n2. Extract the zip anywhere on your harddisk.\n3. Finally, open Sample Commander's  _Settings_ dialog and set the location of the extracted FFmpeg files.\n\n##### What is FFmpeg and what's it useful for?\n`FFmpeg` is a free, open-source collection of tools around recording, analysing, converting and streaming audio and video. \nSample Commander uses two executables of `FFmpeg`:\n\n- `ffprobe.exe`  for gathering information on audio files (like sample rate, duration, ...)\n- `ffmpeg.exe`  for generating spectrograms\n\nMore info on the official FFmpeg website: https://ffmpeg.org/\n\n## Development\nDeveloping Sample Commander locally requires `Node.js 8+`.\n```shell\n# install dependencies\nnpm install\n# serve with hot reload at localhost:9080\nnpm run dev\n# build electron application for production\nnpm run build\n# run unit tests\nnpm test\n# lint all JS/Vue component files in `src/`\nnpm run lint\n```\n\n## License\n\nCopyright © 2019-2023 Lennart Pegel\n\nSample Commander is licensed under the [GNU General Public License v3](./LICENSE).\n\nThe brand (incl. the name \"Sample Commander\", logo) is excluded and all rights reserved. \nIf you fork Sample Commander to build your own app, please use a different name and logo, and include some attribution to this repository.\n\nLibraries and modules used in this project are licensed under the GPL and other free software licenses.\n\n\n---\n\n\n## Thanks\nMany thanks to all developers of the libraries/components I used for building Sample Commander, among them:\n\n[Electron](https://electronjs.org/),\n[VueJS](https://vuejs.org/),\n[vuex-pathify](https://github.com/davestewart/vuex-pathify),\n[electron-vue](https://github.com/SimulatedGREG/electron-vue),\n[Buefy](https://buefy.org/documentation/),\n[Bulma](https://bulma.io/documentation/), \nVueDarkMode,\n[vue-multipane](https://github.com/yansern/vue-multipane),\n[readdirp](https://github.com/paulmillr/readdirp)\nand all I forgot in the list.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustlep%2Fsample-commander","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustlep%2Fsample-commander","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustlep%2Fsample-commander/lists"}