{"id":13455023,"url":"https://github.com/martpie/museeks","last_synced_at":"2026-02-19T13:07:33.815Z","repository":{"id":28100322,"uuid":"31598574","full_name":"martpie/museeks","owner":"martpie","description":"🎵 A simple, clean and cross-platform music player","archived":false,"fork":false,"pushed_at":"2025-05-12T09:31:32.000Z","size":13992,"stargazers_count":1812,"open_issues_count":55,"forks_count":206,"subscribers_count":49,"default_branch":"master","last_synced_at":"2025-05-12T10:44:09.323Z","etag":null,"topics":["cross-platform","electron","museeks","music","music-player","react"],"latest_commit_sha":null,"homepage":"https://museeks.io","language":"TypeScript","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/martpie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["martpie"]}},"created_at":"2015-03-03T13:01:31.000Z","updated_at":"2025-05-11T06:59:05.000Z","dependencies_parsed_at":"2023-11-06T09:38:24.255Z","dependency_job_id":"bfcadcc7-1545-4223-8471-7fd994290a12","html_url":"https://github.com/martpie/museeks","commit_stats":null,"previous_names":["keitig/museeks"],"tags_count":47,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martpie%2Fmuseeks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martpie%2Fmuseeks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martpie%2Fmuseeks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/martpie%2Fmuseeks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/martpie","download_url":"https://codeload.github.com/martpie/museeks/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254101618,"owners_count":22014909,"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":["cross-platform","electron","museeks","music","music-player","react"],"created_at":"2024-07-31T08:01:00.417Z","updated_at":"2025-10-04T10:04:51.934Z","avatar_url":"https://github.com/martpie.png","language":"TypeScript","readme":"# Museeks\r\n\r\n![build](https://github.com/martpie/museeks/actions/workflows/build.yml/badge.svg?branch=master)\r\n![GitHub All Releases](https://img.shields.io/github/downloads/martpie/museeks/total)\r\n\r\nA simple, clean, and cross-platform music player. ([museeks.io](https://museeks.io))\r\n\r\n![Screenshot](screenshot.png)\r\n\r\n## Features\r\n\r\nMuseeks aims to be a simple and easy-to-use music player with a clean UI. You will not find tons of features, as its goal is not to compete with more complete and more famous music players.\r\n\r\nHere is a little preview though:\r\n\r\n- 💻 Cross-platform music player (Linux, macOS, and Windows)\r\n- 🎧 Supported formats: mp3, mp4, m4a/aac, flac, wav, ogg, 3gpp\r\n- 🔄 Library auto-refresh\r\n- 🌟 Playlists\r\n- 🎼 Queue management\r\n- ➰ Shuffle, loop\r\n- 🌄 Cover art\r\n- 🤓 Dark theme\r\n- 🚤 Playback speed control\r\n- 😴 Sleep mode blocker\r\n- 📥 `.m3u` import/export\r\n\r\nWant more? Open a new issue or 👍 an existing one so we can talk about it.\r\n\r\n## Installation\r\n\r\nBinaries/Installers can be found [on the releases page](https://github.com/martpie/museeks/releases).\r\n\r\n\u003e [!NOTE]\r\n\u003e The publication of Museeks to package managers is community-maintained. Museeks may be available there (like Homebrew, AUR, etc.), but there is no guarantee it will be the latest version.\r\n\r\n## Release Notes\r\n\r\n[Over here!](https://github.com/martpie/museeks/releases)\r\n\r\n## Bugs\r\n\r\nPlease open an issue on GitHub, mention your OS, your Museeks version, and how to reproduce it. Adding a screenshot of the console (Menu -\u003e View -\u003e Toggle Developer Tools) is a big help too.\r\n\r\nThank you!\r\n\r\n## Troubleshooting\r\n\r\nSince version `0.20`, I try to keep things as backwards-compatible as possible, but I may miss some edge cases.\r\n\r\nIf you encounter freezes or crashes when using the app, you can reset Museeks.\r\n\r\n\u003cdetails\u003e\r\n  \u003csummary\u003eReset Museeks\u003c/summary\u003e\r\n\r\n  - Go to Settings -\u003e Open Storage Directory\r\n  - Alternatively, go to the Museeks folder directly:\r\n    - Windows: `%AppData%\\museeks`\r\n    - macOS: `~/Library/Application Support/museeks`\r\n    - Linux: `~/.config/museeks/` or `$XDG_CONFIG_HOME/museeks`\r\n  - Delete everything there\r\n  - Restart Museeks\r\n\r\n\u003c/details\u003e\r\n\r\nIf you still have problems after that, please open an issue :)\r\n\r\n## Contributing and Development\r\n\r\n### Guidelines\r\n\r\n- Before making complex changes, don't hesitate to open an issue first to discuss it ;)\r\n- Understandable code \u003e short code: comment if needed\r\n- That's it :)\r\n\r\n### Setup\r\n\r\nMuseeks is built upon:\r\n\r\n- Back-end: [Tauri v2](https://v2.tauri.app/) / Rust 🦀\r\n- UI: [React.js](https://react.dev)\r\n\r\nSo you will need to install the following dependencies:\r\n\r\n- [Tauri requirements](https://v2.tauri.app/start/prerequisites/) for `rust`\r\n- [`Node.js`](https://nodejs.org)\r\n\r\nThen you can:\r\n\r\n- Fork the repository\r\n- `git clone git@github.com:\u003cusername\u003e/museeks.git`\r\n- `cd museeks`\r\n\r\n### Development Mode\r\n\r\n- `npm ci`\r\n- `npm run tauri dev`\r\n\r\nThis will launch Museeks in dev mode. Hot reload will work out-of-the-box, so when you update a `.js` file, the UI will automatically update. When you edit a `.rs` file, Museeks will automatically rebuild.\r\n\r\n### Package Binaries\r\n\r\n- `npm ci`\r\n- `npm run tauri build`\r\n\r\nTauri does not support cross-platform binaries, so the command will only generate binaries for your current platform (macOS, Linux, or Windows).\r\n\r\n### Translations\r\n\r\n- Follow the steps from the \"Setup\" and \"Development Mode\" sections\r\n- Go to `src/translations/languages.ts`\r\n- Add your language information to the list\r\n- Run `npm run gen:translations`\r\n- This will create a new file `\u003cyour_language_code\u003e.po` in the same folder\r\n- Fill in the translations from the created `.po` file\r\n- Open a Pull Request\r\n\r\n\u003cdetails\u003e\r\n  \u003csummary\u003ePluralization Help\u003c/summary\u003e\r\n\r\n  - [Pluralization guide](https://lingui.dev/guides/plurals)\r\n  - [Pluralization reference](https://www.unicode.org/cldr/charts/42/supplemental/language_plural_rules.html)\r\n\r\n\u003c/details\u003e\r\n\r\nps: _Translations are in an early stage. If your language has \"special\" characteristics, like right-to-left, specific locales instead of languages, or something else, Museeks might not be ready for it yet. Please open an issue to discuss it!_\r\n","funding_links":["https://github.com/sponsors/martpie"],"categories":["TypeScript","Music","Applications","Multimedia","应用","Audio and Video Tools","Repository app"],"sub_categories":["TOPs","Audio","Media Servers","音频"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartpie%2Fmuseeks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmartpie%2Fmuseeks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmartpie%2Fmuseeks/lists"}