{"id":20722465,"url":"https://github.com/toomanybees/djesbe","last_synced_at":"2025-09-13T16:08:42.583Z","repository":{"id":24869556,"uuid":"28285238","full_name":"TooManyBees/djesbe","owner":"TooManyBees","description":"Terminal audio player written for Node","archived":false,"fork":false,"pushed_at":"2015-03-13T03:39:35.000Z","size":748,"stargazers_count":9,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-09-06T10:31:16.314Z","etag":null,"topics":[],"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/TooManyBees.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":"2014-12-21T01:51:06.000Z","updated_at":"2019-08-13T15:58:23.000Z","dependencies_parsed_at":"2022-08-31T23:50:41.455Z","dependency_job_id":null,"html_url":"https://github.com/TooManyBees/djesbe","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/TooManyBees/djesbe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TooManyBees%2Fdjesbe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TooManyBees%2Fdjesbe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TooManyBees%2Fdjesbe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TooManyBees%2Fdjesbe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TooManyBees","download_url":"https://codeload.github.com/TooManyBees/djesbe/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TooManyBees%2Fdjesbe/sbom","scorecard":{"id":142919,"data":{"date":"2025-08-11","repo":{"name":"github.com/TooManyBees/djesbe","commit":"77ffa49de413d247a8852b3dbe59dcf5fbee3519"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.6,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}}]},"last_synced_at":"2025-08-16T08:35:58.766Z","repository_id":24869556,"created_at":"2025-08-16T08:35:58.766Z","updated_at":"2025-08-16T08:35:58.766Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274989809,"owners_count":25386552,"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-09-13T02:00:10.085Z","response_time":70,"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":[],"created_at":"2024-11-17T03:35:57.941Z","updated_at":"2025-09-13T16:08:42.556Z","avatar_url":"https://github.com/TooManyBees.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# djesbe\n\nTerminal based audio player for Node.js. Written to solve my very specific problem: how to DJ my own party maintaining an easy to view record of all the songs I had already played.\n\n## App\n\n![Terminal interface of the app](sample.png)\n\n`dj [path/to/playlists]` loads djesbe as a terminal app. Path can be left blank to scan the current directory.\n\nThe top left pane is a list of `m3u8` files that the app found and parsed. The lower left pane is a list of tracks in the selected playlist. The right pane is the actual queue of tracks to play. As tracks get enqueued, they are grayed out from the track pane (though they are still playable).\n\nFrom anywhere\n* `tab` toggles focus between the queue and the selection panes\n* `space` starts and stops the current track in the queue\n* `shift-right` and `shift-left` skip forward and backward in the queue\n\nFrom the playlist pane (app starts with it focused)\n* `enter` selects a playlist and expands the track pane\n* `a` marks a playlist as \"autoplay.\" The jukebox will pull from this list if the queue runs dry\n* `e` enqueues all tracks at once, ignoring those already queued up. `shift-e` enqueues everything without checking\n\nFrom the track pane\n* `enter` enqueues a track\n* `escape` shrinks the pane and returns focus to the playlist pane\n* `e` and `shift-e`, as above\n\nFrom the queue\n* `enter` skips directly to the selected track and plays it\n* `delete` and `backspace` removes that track from the queue\n\n## Library\n\nIf this module is required from within node, it will just expose `Jukebox` and `Track`. Most of the async flow is controlled (poorly, at the moment) by promises.\n\n`Jukebox.load(directory)` parsed all of the `m3u8` files in the specified directory, turning them into arrays of `Track`s. It returns a promise.\n\n`Track.unique` is a constructor that memoizes tracks by filename, so that multiple playlists can load duplicates of the same file without generating multiple copies of it in memory.\n\nA `Track` is responsible for playing itself with the `play`, `stop`, and `isPlaying` methods.\n\nA `Jukebox` loads the playlists, maintains the queue of tracks to play, and keeps the queue playing tunes. It has `enqueue`, `play`, and `stop` methods that each take a `Track` object as their only argument; they also handle the callbacks that enable the next track in the queue to autoplay. The `unqueue` method is tricky because even though it should accept a `Track`, it accepts an index instead (the queue must be able to contain duplicate tracks, so it need to know which index is being removed from the queue). `Jukebox.advance` takes an integer, positive or negative, and skips that many tracks ahead or behind in the queue.\n\n# To do\n\n1. The queue needs its own model to move logic out of Jukebox\n2. AAC support\n3. \"undo\" levels (maybe just 1)\n4. websocket interface?\n\n# Bites\n\nCurrently supports only `mp3` and `ogg` files. (It will filter out extensions that it does not support.)\n\nSome of the architecture has come from poring over the [Decibel](https://github.com/scttnlsn/decibel) project for insights.\n\nA few alterations were made to [Blessed](https://github.com/chjj/blessed) as well, to accomodate how I preferred to use list boxes.\n\nI meant to type \"Notes\" for this section but my right hand was off a letter.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoomanybees%2Fdjesbe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoomanybees%2Fdjesbe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoomanybees%2Fdjesbe/lists"}