{"id":13753660,"url":"https://github.com/BonnyAD9/uamp","last_synced_at":"2025-05-09T21:35:24.923Z","repository":{"id":164512115,"uuid":"639963684","full_name":"BonnyAD9/uamp","owner":"BonnyAD9","description":"Universal Advanced Music Player written in Rust.","archived":false,"fork":false,"pushed_at":"2025-05-06T16:04:43.000Z","size":973,"stargazers_count":13,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-06T16:42:04.918Z","etag":null,"topics":["audio-player","audio-server","music-player","music-server","rust"],"latest_commit_sha":null,"homepage":"https://bonnyad9.github.io/uamp","language":"Rust","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/BonnyAD9.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":"2023-05-12T16:25:52.000Z","updated_at":"2025-05-06T16:04:46.000Z","dependencies_parsed_at":"2024-05-17T12:25:24.386Z","dependency_job_id":"459cb1b3-508b-40f0-bcd8-6e47bf491e9f","html_url":"https://github.com/BonnyAD9/uamp","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonnyAD9%2Fuamp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonnyAD9%2Fuamp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonnyAD9%2Fuamp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BonnyAD9%2Fuamp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BonnyAD9","download_url":"https://codeload.github.com/BonnyAD9/uamp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253328967,"owners_count":21891558,"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-player","audio-server","music-player","music-server","rust"],"created_at":"2024-08-03T09:01:26.815Z","updated_at":"2025-05-09T21:35:24.908Z","avatar_url":"https://github.com/BonnyAD9.png","language":"Rust","readme":"# uamp\n[![version][aur-badge]][aur]\n\nUniversal Advanced Music Player written in Rust.\n\nUamp is a minimal music player that doesn't get in your way. It is fast,\nreliable, and powerful.\n\nUamp currently works as playback server controled with CLI.\n\n## Configuration\nThe configuration is saved in the efault configuration folder on your\nplatform. You can use `uamp config` to open the config file with your default\neditor.\n\n## CLI\nSee short help of uamp:\n```sh\nuamp -h\n```\n\n### Examples\n\nShow help with all the options (shortest version):\n```sh\nuamp h all\n```\n\nTo play/pause you can use the command:\n```sh\nuamp instance play-pause\n```\nor the short version\n```sh\nuamp i pp\n```\n\nTo start uamp in backgound:\n```sh\nuamp run -d\n```\nor short:\n```sh\nuamp -R-d\n```\n\nStop the running instance:\n```sh\nuamp i x\n```\n\nShow info about now playing:\n```sh\nuamp -Info\n```\n\nSet the playlist to all songs, shuffle and play:\n```sh\nuamp i sp sort=rng pj pp=play\n```\n\nPlay file in the currently running instance:\n```sh\nuamp i play='path/to/file.flac'\n```\n\n## How it looks\nCurrently uamp has no GUI or TUI. The closest thing to gui that uamp has is the\noutput of `uamp -Info`:\n\n![image](https://github.com/user-attachments/assets/9fa6cb61-853c-425b-8f81-48908a4ea196)\n\n## Possible uamp setup\nThis is the way that I have confugred and use uamp:\n\nMake uamp start on startup with your cmomputer with the command `uamp`\n(or `uamp -R-d` to make it detached).\n\nUse your OS settings to bind global shortcuts to commands for controlling uamp.\nFor example:\n- **`Ctrl` + `Alt` + `Home`:** `uamp i pp` (play/pause)\n- **`Ctrl` + `Alt` + `PgUp`:** `uamp i ps` Previous song\n- **`Ctrl` + `Alt` + `PgDown`:** `uamp i ns` Next song\n- **`Ctrl` + `Alt` + `Up`:** `uamp i vu` Volume up\n- **`Ctrl` + `Alt` + `Down`:** `uamp i vd` Volume down\n- **`Ctrl` + `Alt` + `Left`:** `uamp i rw` Rewind\n- **`Ctrl` + `Alt` + `Right`:** `uamp i ff` Fast forward\n\nNow you can just start playing when you want to by using your global shortcut.\n\n### Endless playback\nIf you want to setup endless playback of your songs shuffled you can also:\n\ncreate alias in `config.json`:\n```json\n{\n  // ...\n  \"control_aliases\": {\n    // ...\n    \"reset-playlist\": \"sp sort=rng pj pp=play pap=m spea=reset-playlist\"\n  }\n}\n```\n\nNow you can start the playback with `uamp i al=reset-playlist` and you never\nhave to worry about it. It will shuffle all your songs into a playlist and when\nthe playlist ends it will reshuffle the playlist and start from the start.\n\nWhen you will load new songs, they will also be automatically mixed in the\nplaylist after the currently playing song.\n\n### Custom tab complete\nUamp can also provide custom tab completion for any bash like shell (works in\nzsh). To do that add this to your `.bashrc`/`.zshrc`/...:\n```sh\n`uamp sh tab`\n```\nAnd that is it. Uamp will now have custom tab completion.\n\n## How to get it\n\n### Arch linux\nIf you have arch, you can install it from [aur][aur].\n\n### Linux single line install\nThis install script will ask for sudo privilages to move the build files to\ntheir apropriate locations.\n\n```sh\nwget -nv -O - https://raw.githubusercontent.com/BonnyAD9/uamp/master/packages/script/install.sh | sh\n```\n\n### Build from source\n\nIf you don't have arch, you have to compile it yourself, but that shouldn't be\nany problem because all you need is `cargo`:\n```sh\ncargo build -r\n```\nthe binary will be `./target/release/uamp`. It doesn't depend on any other\nfiles.\n\n## Links\n- **Author:** [BonnyAD9][author]\n- **GitHub repository:** [BonnyAD9/uamp][github]\n- **My website:** [bonnyad9.github.io][my-web]\n- **Project website:** [bonnyad9.github.io/uamp][uamp-web]\n- **Aur package:** [aur.archlinux.org][aur]\n\n\n[author]: https://github.com/BonnyAD9\n[github]: https://github.com/BonnyAD9/uamp\n[my-web]: https://bonnyad9.github.io/\n[uamp-web]: https://bonnyad9.github.io/uamp/\n[aur]: https://aur.archlinux.org/packages/uamp\n[aur-badge]: https://img.shields.io/aur/version/uamp\n","funding_links":[],"categories":["Rust"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBonnyAD9%2Fuamp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FBonnyAD9%2Fuamp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FBonnyAD9%2Fuamp/lists"}