{"id":13558718,"url":"https://github.com/joelpurra/npshell","last_synced_at":"2025-03-23T13:31:35.225Z","repository":{"id":23820727,"uuid":"27197474","full_name":"joelpurra/npshell","owner":"joelpurra","description":"Command line music queue manager. A music player from the comfort of your own shell.","archived":false,"fork":false,"pushed_at":"2021-02-24T17:32:48.000Z","size":131,"stargazers_count":15,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-18T20:46:57.879Z","etag":null,"topics":["command-line-interface","daemon","music-player","music-playlist","shell"],"latest_commit_sha":null,"homepage":"https://joelpurra.com/projects/npshell/","language":"Shell","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/joelpurra.png","metadata":{"files":{"readme":"README.md","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}},"created_at":"2014-11-26T21:43:03.000Z","updated_at":"2024-01-04T15:46:01.000Z","dependencies_parsed_at":"2022-07-10T10:16:56.884Z","dependency_job_id":null,"html_url":"https://github.com/joelpurra/npshell","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelpurra%2Fnpshell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelpurra%2Fnpshell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelpurra%2Fnpshell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/joelpurra%2Fnpshell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/joelpurra","download_url":"https://codeload.github.com/joelpurra/npshell/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245108177,"owners_count":20562000,"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":["command-line-interface","daemon","music-player","music-playlist","shell"],"created_at":"2024-08-01T12:05:07.113Z","updated_at":"2025-03-23T13:31:34.885Z","avatar_url":"https://github.com/joelpurra.png","language":"Shell","readme":"# [npshell `np` -- command line music queue manager](https://github.com/joelpurra/npshell/)\n\nKeep a daemon running in the background. Add sounds to a queue. Let the daemon play the sweet music for you. All from the comfort of your own shell.\n\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/joelpurra/npshell/\"\u003e\u003cimg src=\"https://cloud.githubusercontent.com/assets/1398544/5836151/b8d8e31e-a171-11e4-8412-d23765b54a25.gif\" alt=\"npshell in action\" border=\"0\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\n- Strictly command line based for extra nerd credits.\n- Adds sounds from deep folder structures by default.\n- Control music playback daemon from any terminal window.\n- Displays song paths relative to `$PWD`.\n- Optional system notifications displaying the path or id3v2 tags.\n- Creates cached/index files to handle large sound libraries, useful on slow disks and network drives.\n- Works on Mac OS X, Linux, and similar systems.\n\n\n\n## Installation\n\nSee [INSTALL.md for Linux, other systems, and manual steps](INSTALL.md) as well as how to enable notifications.\n\nOn Mac with [Homebrew](https://brew.sh/):\n\n```bash\nbrew tap joelpurra/joelpurra\nbrew install npshell\nbrew services start npshell\n```\n\n\n\n## Get started\n\nSee [USAGE.md for the full list of command and configuration](USAGE.md) with examples.\n\nEveryday usage, assuming `np daemon` has been started elsewhere:\n\n```bash\ncd Music/     # Go to a folder with some sounds.\nnp add 10     # Add 10 shuffled sounds from current folder hierarchy.\nnp next       # Play next sound.\nnp            # Display the currently playing sound.\nnp list       # List sounds in queue.\n              # Add an album by folder path.\nnp add all in-order \"Jazz/My Favorite Album/\"\n```\n\n\n\u003cdetails\u003e\n  \u003csummary\u003eConvenient aliases\u003c/summary\u003e\n\nSave a keystroke or two, at least until tab completion is... completed. Add to your `~/.bash_profile` or similar autoexecuted file of your choice.\n\n```bash\nalias npa='np add'\nalias npn='np next'\nalias npl='np list'\n```\n\n\u003c/details\u003e\n\n---\n\nCopyright (c) 2014, 2015, 2016, 2017 [Joel Purra](https://joelpurra.com/). Released under [GNU General Public License version 3.0 (GPL-3.0)](https://www.gnu.org/licenses/gpl.html).\n","funding_links":[],"categories":["Shell","shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoelpurra%2Fnpshell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjoelpurra%2Fnpshell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjoelpurra%2Fnpshell/lists"}