{"id":13571531,"url":"https://github.com/moonwave99/playa-old","last_synced_at":"2025-04-04T08:31:23.825Z","repository":{"id":33414644,"uuid":"37059886","full_name":"moonwave99/playa-old","owner":"moonwave99","description":"The OS X Audio Player that thinks in albums.","archived":true,"fork":false,"pushed_at":"2020-03-05T23:16:38.000Z","size":4247,"stargazers_count":76,"open_issues_count":14,"forks_count":7,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-11-05T04:34:12.318Z","etag":null,"topics":["audio-player","discogs","electron","lastfm","osx","react"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/moonwave99.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-08T10:14:17.000Z","updated_at":"2023-03-11T17:23:55.000Z","dependencies_parsed_at":"2022-08-29T00:10:21.048Z","dependency_job_id":null,"html_url":"https://github.com/moonwave99/playa-old","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonwave99%2Fplaya-old","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonwave99%2Fplaya-old/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonwave99%2Fplaya-old/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moonwave99%2Fplaya-old/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moonwave99","download_url":"https://codeload.github.com/moonwave99/playa-old/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247147225,"owners_count":20891651,"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","discogs","electron","lastfm","osx","react"],"created_at":"2024-08-01T14:01:02.842Z","updated_at":"2025-04-04T08:31:20.369Z","avatar_url":"https://github.com/moonwave99.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Playa\n\n**Playa** is the OS X audio player for those who enjoy thinking in playlist of beautiful albums, rather than shuffling over messed collections.\n\n![Playa Screenshot](docs/images/playa.png)\n\n## Features\n\n- Plays `mp3`, `m4a`, `flac`, `ogg` files;\n- open playlists in multiple tabs;\n- displays track [waveform](https://github.com/andrewrk/waveform);\n- displays album cover art from [Discogs](https://www.discogs.com/developers/);\n- [scrobbles to your Last.fm account](http://www.last.fm/about);\n- allows remote control over HTTP.\n\n## Philosophy\n\nI put it straight: in ~ 10 years of OS X usage, I never found a music player that completely satisfied my needs, mostly because of playlist organisation.\nMost players, if not all, handle playlists as a list of _tracks_, rather than as a list of _albums_, the latter being at least for me the atom (no technology pun intended) of the listening experience.\n\nSo now that I found a solid match between a low level audio player, and an application environment easy to work with (namely [Electron](https://github.com/atom/electron)), I stopped whining and started working on my idea of audio player, soon a _concrete_ audio player.\n\n## Install\n\nEither [download the latest build from here](https://github.com/moonwave99/playa/releases), or build manually:\n\n    $ npm install\n    $ gulp release\n\nYou'll find built app in the `/release` folder.\n\n## Development\n\n### Run\n\n    $ npm i\n    $ npm rebuild // see * below\n    $ npm start\n\n\\* (in case you install new native modules and you run into the [dreadful module version mismatch issue](https://github.com/electron-userland/electron-builder/issues/453))\n\n### Test\n\n    $ npm run test\n\nTests are written in [tape](https://github.com/substack/tape) and should live along the code itself:\n\n```\npathTo\n  └── component\n        ├── __stubs__\n        |       └── index.js\n        ├── index.js\n        ├── component.js\n        └── component.spec.js\n```\n\nWhere `index.js`is just:\n\n```\nimport Component from './component';\n\nexport default Component;\n```\n\nThe template for specs is:\n\n```\nimport test from 'tape';\nimport Component from './';\n\ntest('whatToTest', (assert) =\u003e {\n  ...\n  assert.equal(\n    something, toSomethingElse,\n    'expected result',\n  );\n  ...\n  assert.end();\n});\n```\n\nIf the need to mock underlyings deps arises, use [proxyquire](https://www.npmjs.com/package/proxyquire) and place stubs into `__stubs__/index.js`:\n\n```\nexport const Component = proxyquire('../Component', {\n  __esModule: true,\n  'lib_to_mock': {\n    method_to_mock: () =\u003e ...,\n  },\n});\n```\n\nImport in the spec file accordingly then:\n\n```\nimport { Component } from './__stubs__';\n...\n```\n\nKeep in mind that proxyquire proxies the deps only, not the component itself, and it is meant to simulate network / fs layers. An abuse of its features is a smell of tight coupling, and implies a lot of work. Work less, and save tight coupling for the weekend.\n\n---\n\n**Note**: in order to use [Discogs webservice](https://www.discogs.com/developers/) you need to obtain a Consumer Key/Secret pair from them and create `settings/discogs.json` using following template:\n\n    {\n      \"DISCOGS_KEY\"     : \u003cyourDiscogsKey\u003e,\n      \"DISCOGS_SECRET\"  : \u003cyourDiscogsSecret\u003e\n    }\n\nSame for [Last.fm scrobbling](http://www.last.fm/api/scrobbling), please save it to `settings/lastfm.json`:\n\n    {\n      \"LASTFM_KEY\"     : \u003cyourLastFmKey\u003e,\n      \"LASTFM_SECRET\"  : \u003cyourLastFmSecret\u003e\n    }\n\n## Roadmap\n\nPlans for the close future are:\n\n- Implementation of `MetaDoctor`, an interface driven process that help you **solve track metadata problems** when importing media to playlists.\n\nPlans for the not-so-close future:\n\n- **search feature** over a library, whose changes are monitored;\n- inclusion of arbitrary media **URLs** in playlists (Youtube, Soundcloud, Bandcamp...).\n\n## Known issues\n\n- no drag and drop of multiple albums/folders.\n\n## License\n\nThe MIT License (MIT)\n\nCopyright (c) 2015-2017 Diego Caponera\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoonwave99%2Fplaya-old","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoonwave99%2Fplaya-old","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoonwave99%2Fplaya-old/lists"}