{"id":15681798,"url":"https://github.com/matthieu-rolland/spoticly","last_synced_at":"2025-08-20T18:36:21.193Z","repository":{"id":57367814,"uuid":"133311583","full_name":"matthieu-rolland/spoticly","owner":"matthieu-rolland","description":"Browse, control and listen to spotify from the command line","archived":false,"fork":false,"pushed_at":"2020-03-10T17:33:50.000Z","size":1667,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-19T12:36:35.677Z","etag":null,"topics":["cli","spotify","spotify-alternative","spotify-api","spotify-cli","spotify-playlist","spotify-web-api"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matthieu-rolland.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-05-14T05:58:27.000Z","updated_at":"2022-08-24T15:04:53.000Z","dependencies_parsed_at":"2022-08-23T19:30:37.557Z","dependency_job_id":null,"html_url":"https://github.com/matthieu-rolland/spoticly","commit_stats":null,"previous_names":["breizoreol/spoticly"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthieu-rolland%2Fspoticly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthieu-rolland%2Fspoticly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthieu-rolland%2Fspoticly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matthieu-rolland%2Fspoticly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matthieu-rolland","download_url":"https://codeload.github.com/matthieu-rolland/spoticly/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252881222,"owners_count":21819125,"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":["cli","spotify","spotify-alternative","spotify-api","spotify-cli","spotify-playlist","spotify-web-api"],"created_at":"2024-10-03T17:00:12.706Z","updated_at":"2025-05-07T12:44:34.830Z","avatar_url":"https://github.com/matthieu-rolland.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# SPOTICLY\n\n[![NPM](https://nodei.co/npm/spoticly.png)](https://nodei.co/npm/spoticly/) [![Build Status](https://travis-ci.org/breizoreol/spoticly.svg?branch=master)](https://travis-ci.org/breizoreol/spoticly) ![npm](https://img.shields.io/npm/dt/spoticly.svg)\n\n\nBrowse, control and listen to spotify from the command line (mac os only for now, windows support might come later)\n\n## Why would I need this?\nI am on dual screen at work and I was fed up with switching from command line/ editor to spotify all the time, also I was not happy with already existing CLI solutions, I made this CLI utility to spare me some time. Context switching aside, it's actually even faster than using the GUI. \n\n![alt text](https://github.com//breizoreol/spoticly/blob/master/demo.gif?raw=true) \n\n## INSTALL AND SETUP\n\n### INSTALL\n\n```\nnpm install -g spoticly\n\n````\n\n### FIRST USE\nGet your credentials (spotify client ID and secret token) by creating an app at this address: https://developer.spotify.com/my-applications\nIt's fast and easy, put whatever in the form.\n\nSpoticly will ask for it the first time you use it.\n\n## Usage\n\n### Listen to an artist\nBy default, you will get to choose among an artist's **albums** using this command:\n```\n    spoticly artist radiohead\n````\n\nUse the '**--choose**' option or just 'ch' if you need to **choose** among several artists, it's useful if several artists have similar names, ex:\n```\n    spoticly artist ch radiohead\n    spoticly artist --choose radiohead\n\n    (will give you a list of artists to choose from)\n````\n\nUse the '**all**' option if you want to select not only albums but also singles and compilations (without this option, you will get to choose among albums only)\n\n```\n    spoticly artist all nirvana\n````\n\nUse the '**--top-tracks**' option, or just 'tt' if you just want to listen to the artist's **top tracks**, ex:\n\n````\n    spoticly artist tt qotsa\n\n    (will play Queen of the Stone Age's top tracks)\n````\n\n### Listen to a playlist\n\nUse this command to choose a **playlist** or its shortcut '**pl**':\n\n```\n    spoticly playlist \"chanson française\"    \n    spoticly pl \"chanson française\"\n````\n\n### Listen to a specific track\n\nYou can search for a specific track using the \"**track**\" command, or '**tr**'\n\n```\n    spoticly track \"song for the dead\"\n    spoticly tr \"song for the dead\"\n````\n\n### Navigate inside an album or a playlist\nUse '**track-list**' or '**tr**' to display and navigate inside an album or playlist\n\n```\n    spoticly track-list\n    spoticly tl\n````\n\n\n### CONTROLS AND OTHER COMMANDS\n\nUse the --help command to get a detailed list of all features (play/pause/next/previous etc...)\n````\n    spoticly --help\n````\n\n## TODO\n\n Improve tests, get a user's playlists, paginate long playlists, add an about command, notify updates...\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatthieu-rolland%2Fspoticly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatthieu-rolland%2Fspoticly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatthieu-rolland%2Fspoticly/lists"}