{"id":19522053,"url":"https://github.com/aretrosen/teamus","last_synced_at":"2025-04-26T09:32:03.742Z","repository":{"id":163762802,"uuid":"639207479","full_name":"aretrosen/teamus","owner":"aretrosen","description":"Dead simple terminal music player written in go","archived":false,"fork":false,"pushed_at":"2024-05-02T00:01:30.000Z","size":54,"stargazers_count":40,"open_issues_count":2,"forks_count":5,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-04T10:28:11.964Z","etag":null,"topics":["audio-playback","audio-player","go","golang","golang-application"],"latest_commit_sha":null,"homepage":"","language":"Go","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/aretrosen.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-11T01:55:18.000Z","updated_at":"2025-03-15T17:29:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"cd73db13-55bd-47e4-aafb-fbb08cb1eb23","html_url":"https://github.com/aretrosen/teamus","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aretrosen%2Fteamus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aretrosen%2Fteamus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aretrosen%2Fteamus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aretrosen%2Fteamus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aretrosen","download_url":"https://codeload.github.com/aretrosen/teamus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250967192,"owners_count":21515558,"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-playback","audio-player","go","golang","golang-application"],"created_at":"2024-11-11T00:36:56.638Z","updated_at":"2025-04-26T09:32:03.500Z","avatar_url":"https://github.com/aretrosen.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# teamus\n\nDead simple terminal music player written in go.\n\nhttps://github.com/aretrosen/teamus/assets/125266845/54d2c00a-dd53-49da-a0b1-4c4cfb5b147f\n\nThis shows the mouse, seek, play/pause and other features.\n\n(I had to search for music with no copyright. The two music played are Rumors by Neffex, and Cold Funk by Kevin MacLeod. The recording app is Kooha.)\n\n\n## Purpose\n\n_Pretty Keyboard centric Terminal Music Player in Go using the popular Charm TUI, with Vim Keybindings_\n\nMost Terminal Music Player today is either not pretty, or have the most unintuitive key bindings. This one is meant to be pretty, without being much resource intensive. Written in Go, it can search for all audio files in your Music Folder, and then Play the songs on `enter`. Check out the project, and click the question mark `?` to get more help. I love `cmus`, but it isn't pretty, so now we get `teamus`.\n\n## Build Instructions\n\nFor now, you have to have the golang binary installed. For that, check out, check out [\"How to Build and Install Go Programs\"](https://www.digitalocean.com/community/tutorials/how-to-build-and-install-go-programs). After that just clone this repository, and type `go run .`. Or maybe you can build the repository using `go build`. Also, you can test this repo by using the command `go run github.com/aretrosen/teamus@latest`.\n\n~**NOTE:** This was made in a Linux environment, with a Music directory. There are plans to add directories via json/yaml file later, but for now you **need** to have the `$HOME/Music` directory.~\nAs mentioned by @LeonardsonCC, this works perfectly fine on Windows, and now it does have the capability to scan other directories which is configured as shown below.\n\n## Configuration\n\nYou can specify a list of song directories by creating a JSON file at `$HOME/.config/teamus/teamus.json` or `$HOME/.teamus.json`.\nFile example:\n\n```json\n{\n  \"directories\": [\"/home/user/Music\", \"/home/user/My_Musics\"]\n}\n```\n\n## To-dos\n\n- [x] Seamless Playing\n- [ ] Shuffle\n- [x] Repeat Music / Playlist\n- [x] Choose files from multiple directories, specified in json.\n- [ ] Load from database, refresh only on key press.\n\n### Additional Features\n\n- [ ] show lyrics on key press.\n- [x] basic mouse support added now. If more support is needed, I might consider using bubblezone module.\n- [ ] play `m4a` audio. Currently, even not all `opus` files run correctly. I might have to write many of the audio frameworks from scratch.\n\n## Collaboration\n\nYou're welcome to write features and report issues for this project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faretrosen%2Fteamus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faretrosen%2Fteamus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faretrosen%2Fteamus/lists"}