{"id":13941113,"url":"https://github.com/irskep/summertunes","last_synced_at":"2025-10-11T04:07:22.046Z","repository":{"id":66658213,"uuid":"76800404","full_name":"irskep/summertunes","owner":"irskep","description":"A web-based music player for Beets","archived":false,"fork":false,"pushed_at":"2017-06-25T21:11:18.000Z","size":2320,"stargazers_count":17,"open_issues_count":6,"forks_count":0,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-29T18:06:11.594Z","etag":null,"topics":["amarok","beets","flask","groovebasin","itunes","kefir","mopidy","mpv","music","python3","react"],"latest_commit_sha":null,"homepage":null,"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/irskep.png","metadata":{"files":{"readme":"Readme.rst","changelog":null,"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":"2016-12-18T18:49:51.000Z","updated_at":"2023-07-30T20:13:56.000Z","dependencies_parsed_at":"2023-02-21T02:46:03.344Z","dependency_job_id":null,"html_url":"https://github.com/irskep/summertunes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/irskep/summertunes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irskep%2Fsummertunes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irskep%2Fsummertunes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irskep%2Fsummertunes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irskep%2Fsummertunes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/irskep","download_url":"https://codeload.github.com/irskep/summertunes/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/irskep%2Fsummertunes/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006256,"owners_count":26084060,"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-10-11T02:00:06.511Z","response_time":55,"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":["amarok","beets","flask","groovebasin","itunes","kefir","mopidy","mpv","music","python3","react"],"created_at":"2024-08-08T02:01:11.432Z","updated_at":"2025-10-11T04:07:22.032Z","avatar_url":"https://github.com/irskep.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"Summertunes\n===========\n\nSummertunes is a web-based music player that can control mpv on a\nserver, or play back audio in your browser.\n\nRequirements\n------------\n\nPython 3.5; beets \u003e=1.4.4; mpv\n\n.. figure:: https://www.dropbox.com/s/i1yf42p5vu7eidt/Screenshot%202017-01-17%2012.59.32.png?dl=1\n   :alt: Screenshot\n\nInstallation\n------------\n\n.. code:: sh\n\n    # Install mpv on your platform\n    brew install mpv\n    # Install summertunes from PyPI\n    pip install summertunes\n\nAdd this to your beets config (on OS X, at ``~/.config/beets/config.yaml``):\n\n.. code:: yaml\n\n    plugins: web summertunes\n    web:\n        include_paths: true  # without this, summertunes can't control mpv\n\nIf you haven't used beets before, import your files into beets without\nrewriting tags or copying:\n\n.. code:: sh\n\n    beet import -A -C /folder/of/files\n\nRunning\n-------\n\nIn terminal A, run ``beet web``:\n\n.. code:: sh\n\n    beet web\n\nIn terminal B, use summertunes to run mpv:\n\n.. code:: sh\n\n    summertunes mpv\n\nIn your web browser, visit ``http://localhost:8337/summertunes/``.\n\n**The normal ``beet web`` interface is still at\n``http://localhost:8337/``. Summertunes is served at\n``/summertunes/``.**\n\nConfiguration\n-------------\n\nSummertunes is configured using your beets config file. Here are its\ndefaults:\n\n.. code:: yaml\n\n    summertunes:\n        # port to serve mpv websocket from\n        mpv_websocket_port: 3001\n        # path to use for socket; should be no files with this path\n        mpv_socket_path: /tmp/mpv_socket\n        # show mpv in web interface? otherwise just allow web playback\n        mpv_enabled: yes\n        # last.fm API key, used to fetch album art\n        last_fm_api_key: ''\n        # if using 'summertunes serve' development server, use this port\n        dev_server_port: 3000\n\nDeveloping\n----------\n\nClient\n~~~~~~\n\nYou'll need npm installed to develop the client. To get the\nauto-reloading dev server running, install some stuff:\n\n.. code:: sh\n\n    cd client\n    npm install\n    pip install -r requirements.txt\n    pip install --editable .\n\nUpdate your beets config to allow CORS headers in ``beet web``:\n\n.. code:: yaml\n\n    web:\n        cors: '*'\n        host: 0.0.0.0\n        include_paths: true\n\nNow you can run this in one terminal to serve the JS (but not the API):\n\n.. code:: sh\n\n    summertunes serve --dev  # serves JS\n\nAnd keep ``beet web`` running in another terminal, with the config\nchanges above, so the JS has something to talk to.\n\nServer\n~~~~~~\n\n.. code:: sh\n\n    pip install --editable .\n    beet web --debug # auto-reloads when you change files\n\nBoth\n~~~~\n\nRun ``summertunes serve --dev`` in one terminal and ``beet web --debug``\nin another.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firskep%2Fsummertunes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Firskep%2Fsummertunes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Firskep%2Fsummertunes/lists"}