{"id":15111166,"url":"https://github.com/vhaudiquet/bladeplayer","last_synced_at":"2025-08-15T19:20:04.292Z","repository":{"id":43117492,"uuid":"444546191","full_name":"vhaudiquet/BladePlayer","owner":"vhaudiquet","description":"Android music player that plays from multiple sources","archived":false,"fork":false,"pushed_at":"2024-01-17T11:34:31.000Z","size":8424,"stargazers_count":227,"open_issues_count":20,"forks_count":15,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-05-09T00:05:58.120Z","etag":null,"topics":["android","android-application","music","music-player","player","spotify"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vhaudiquet.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2022-01-04T19:56:03.000Z","updated_at":"2025-05-01T23:36:32.000Z","dependencies_parsed_at":"2022-09-06T19:12:10.376Z","dependency_job_id":"fcda1e54-7a3c-400c-bc85-d6a7479aaf48","html_url":"https://github.com/vhaudiquet/BladePlayer","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/vhaudiquet/BladePlayer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vhaudiquet%2FBladePlayer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vhaudiquet%2FBladePlayer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vhaudiquet%2FBladePlayer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vhaudiquet%2FBladePlayer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vhaudiquet","download_url":"https://codeload.github.com/vhaudiquet/BladePlayer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vhaudiquet%2FBladePlayer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270617870,"owners_count":24617123,"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-15T02:00:12.559Z","response_time":110,"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":["android","android-application","music","music-player","player","spotify"],"created_at":"2024-09-26T00:01:58.318Z","updated_at":"2025-08-15T19:20:04.221Z","avatar_url":"https://github.com/vhaudiquet.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blade Player\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/vhaudiquet/BladePlayer?style=flat-square)\n![license](https://img.shields.io/github/license/vhaudiquet/BladePlayer?style=flat-square)\n![GitHub last commit](https://img.shields.io/github/last-commit/vhaudiquet/BladePlayer?style=flat-square)\n![GitHub commits since latest release (by date)](https://img.shields.io/github/commits-since/vhaudiquet/BladePlayer/latest?style=flat-square)\n\n\u003c!-- Logo --\u003e\n\nBlade is an open source music player for Android, allowing you to play music from multiple\nservices : files on your phone, [Spotify], and more.\n\nBlade is available on [Google Play], or [here on GitHub].\nIt seems to also be on [IzzySoft F-Droid], and to stay up to date there.\n\nOther repos like ~~[Aptoide]~~ or even ~~[ApkPure]~~, ~~[ApkCombo]~~ are not recommended because\nthey don't seem\nto stay up to date fast, and i can't check if they modified the `apk` before publishing it.\n\n\u003cdiv align=\"center\" style=\"text-align: center;\"\u003e\n  \u003cimg src=\"https://valou3433.fr/blade0.png\" width=\"350\" style=\"max-width: 350;\"/\u003e\n  \u003cimg src=\"https://valou3433.fr/blade1.png\" width=\"350\" style=\"max-width: 350;\"/\u003e\n\u003c/div\u003e\n\n## Feature overview\n\nBlade Player is developed by me ([@vhaudiquet]) alone, so the project cannot be tested on many\ndevices and scenarios ; if you find an issue, open one here.\n\n- The app will open on your library, categorized as Artists, Albums, Songs, and Playlists (available\n  in the navigation drawer).\n- It allows you to manage libraries for songs (add/remove from source library) and playlists (\n  add/remove from playlist, create/remove playlists)\n- It supports Android 'dark theme' (the screenshots above are done on a dark themed system).\n- It is completely free (there are no ads, no limited version)\n- It caches the library locally, so launching Blade requires virtually no data (only refreshing\n  tokens and status of sources servers)\n- **(TODO)** It has a 'data saving' mode that allows you to listen to music while consuming very low\n  mobile data (by not loading album arts)\n- The search feature allows you to search the local library instantly\n- The \"explore\" mode allows you to search and browse sources for new music (for example\n  search all Spotify and look for new releases)\n- It has a layout that can adapt for tablet users (landscape layout)\n- It is available in different languages : English, French, German, Turkish ([and you can easily help me traduce it](CONTRIBUTING.md))\n\n\u003cdiv align=\"center\" style=\"text-align: center;\"\u003e\n  \u003cimg src=\"https://valou3433.fr/bladef0.png\" width=\"200\" style=\"max-width: 200;\"/\u003e\n  \u003cimg src=\"https://valou3433.fr/bladef1.png\" width=\"200\" style=\"max-width: 200;\"/\u003e\n  \u003cimg src=\"https://valou3433.fr/bladef2.png\" width=\"200\" style=\"max-width: 200;\"/\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\" style=\"text-align: center;\"\u003e\n  \u003cimg src=\"https://valou3433.fr/bladelandscape.png\" width=\"600\" style=\"max-width: 600;\"/\u003e\n\u003c/div\u003e\n\n### Supported services (music sources)\n\n- Local (i.e. files on your phone)\n- Spotify\n\n### About Spotify\n\nYou will need a **Spotify Premium** account to play music from [Spotify], but you can use Blade\nwithout a premium account (to play your Spotify playlists from other sources, for example)\n\nBlade is using the official [Spotify Android Auth] library and [Retrofit] to access\nthe [Spotify Web API], i.e. to obtain user library and playlists. In order to play music from\nSpotify, Blade uses the [librespot-java] library.\n\nFor now, Blade will act as a Spotify Connect peripheral. **Please do not try to control Blade with\nSpotify Connect**. It won't work, and it will glitch the app.\n\nWhen connecting Blade and Spotify, i am for now obligated to ask directly for your username and\npassword, 2 times : one for [librespot-java], which requires them directly (Spotify does not allow\nstreaming music from their API authentification), and one for [Spotify Android Auth], which uses the\nsecure OAuth2 protocol. I can only promise you that i am not stealing your credentials ; if you are\nparanoid, you may build Blade from sources or use a network analyzer to see that all network traffic\ngoes to [Spotify] servers.\n\nSpecial thanks to the people at [librespot-org] and [librespot-java] ; without them, Spotify support\nwould not have been possible.\n\n## Future updates\n\nNew features and bug fixes or improvements are coming. Here is a list of what i want to implement :\n\n- SPOTIFY: Use Android Native Decoders, and/or libtremolo if native decoder not present\n- UI: Show albums in an 'album view' instead of a list\n- Add new services : SoundCloud, YouTube Music, Amazon Music, Tidal, WebDAV/FTP Servers...\n- CORE: 'Blade' playlists, that can contain song from all sources\n\n## Contributing\n\nSee [CONTRIBUTING.md]\n\n## Older versions\n\nIf you want older (i.e. \u003c 2.0) versions of Blade, you can check the [old repository].\n\n[Google Play]:https://play.google.com/store/apps/details?id=v.blade\n\n[here on GitHub]:https://github.com/vhaudiquet/BladePlayer/releases\n\n[IzzySoft F-Droid]:https://apt.izzysoft.de/fdroid/index/apk/v.blade\n\n[Aptoide]:https://blade-blade.en.aptoide.com/app\n\n[ApkPure]:https://apkpure.com/blade-player/v.blade/\n\n[ApkCombo]:https://apkcombo.com/blade-player/v.blade/\n\n[Spotify]:https://www.spotify.com\n\n[old repository]:https://github.com/vhaudiquet/blade-player\n\n[Spotify Android Auth]:https://github.com/spotify/android-auth\n\n[Retrofit]:https://github.com/square/retrofit\n\n[Spotify Web API]:https://developer.spotify.com/documentation/web-api/\n\n[librespot-java]:https://github.com/librespot-org/librespot-java\n\n[librespot-org]:https://github.com/librespot-org\n\n[@vhaudiquet]:https://github.com/vhaudiquet\n\n[CONTRIBUTING.md]:CONTRIBUTING.md","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvhaudiquet%2Fbladeplayer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvhaudiquet%2Fbladeplayer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvhaudiquet%2Fbladeplayer/lists"}