{"id":19810524,"url":"https://github.com/go-musicfox/spotifox","last_synced_at":"2025-08-28T10:32:19.494Z","repository":{"id":193664141,"uuid":"685539516","full_name":"go-musicfox/spotifox","owner":"go-musicfox","description":"Spotifox is yet another spotify CLI client similar to go-musicfox","archived":false,"fork":false,"pushed_at":"2024-12-13T05:31:42.000Z","size":23395,"stargazers_count":79,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-12-13T06:26:54.129Z","etag":null,"topics":["go","go-musicfox","music","musicfox","spotifox","spotify","spotify-cli","spotify-client","spotify-tui","tui"],"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/go-musicfox.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-08-31T13:09:20.000Z","updated_at":"2024-12-13T05:31:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"8be19cb4-193f-4db8-a1c8-5e240882f0eb","html_url":"https://github.com/go-musicfox/spotifox","commit_stats":null,"previous_names":["go-musicfox/spotifox"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-musicfox%2Fspotifox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-musicfox%2Fspotifox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-musicfox%2Fspotifox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-musicfox%2Fspotifox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/go-musicfox","download_url":"https://codeload.github.com/go-musicfox/spotifox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231254791,"owners_count":18348524,"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":["go","go-musicfox","music","musicfox","spotifox","spotify","spotify-cli","spotify-client","spotify-tui","tui"],"created_at":"2024-11-12T09:22:08.720Z","updated_at":"2024-12-25T16:06:37.017Z","avatar_url":"https://github.com/go-musicfox.png","language":"Go","funding_links":["https://www.buymeacoffee.com/anhoder","https://img.buymeacoffee.com/button-api/?text=Buy"],"categories":[],"sub_categories":[],"readme":"# Spotifox\n\nEnglish | [简体中文](./README_CN.md)\n\nSpotifox is yet another spotify CLI client similar to [go-musicfox](https://github.com/go-musicfox/go-musicfox).\n\n\u003e UI base on [charmbracelet/bubbletea](https://github.com/charmbracelet/bubbletea)\n\n![GitHub repo size](https://img.shields.io/github/repo-size/go-musicfox/spotifox) ![GitHub](https://img.shields.io/github/license/go-musicfox/spotifox) ![Last Tag](https://badgen.net/github/tag/go-musicfox/spotifox) ![GitHub last commit](https://badgen.net/github/last-commit/go-musicfox/spotifox) ![GitHub All Releases](https://img.shields.io/github/downloads/go-musicfox/spotifox/total)\n\n![GitHub stars](https://img.shields.io/github/stars/go-musicfox/spotifox?style=social) ![GitHub forks](https://img.shields.io/github/forks/go-musicfox/spotifox?style=social)\n\n\u003cp\u003e\u003cimg src=\"previews/logo.png\" alt=\"logo\" width=\"512\"/\u003e\u003c/p\u003e\n\n([The icon](https://github.com/go-musicfox/go-musicfox-icon) is based on [kitty-icon](https://github.com/DinkDonk/kitty-icon))\n\n------------------------------\n\n## Preview\n\n#### 1. Startup\n\n![startup](previews/startup.png)\n\n#### 2. MainUI\n\n![main](previews/main.png)\n\n#### 3. Notification\n\n![notify](previews/notify.png)\n\n#### 4. Login\n\n![login](previews/login.png)\n\n#### 5. Search\n\n![search](previews/search.png)\n\n#### 6. macOS NowPlaying\n\n![NowPlaying](previews/nowplaying.png)\n\n## Install\n\n### macOS\n\n#### 1. Homebrew\n\n```sh\n$ brew install go-musicfox/go-musicfox/spotifox\n```\n\n#### 2. Binary\n\nDownload binary file =\u003e [Release](https://github.com/go-musicfox/spotifox/releases/latest)\n\n### Linux\n\n#### 1. Use Distro Package (Recommend)\n\n##### Arch Linux\n\n###### Install From [AUR](https://aur.archlinux.org/)\n\n```sh\n$ paru -S spotifox-bin # Download and install the precompiled binary file\n```\n\n#### 2. Homebrew\n\n```sh\n$ brew install go-musicfox/go-musicfox/spotifox\n```\n\n#### 3. Binary\n\nDownload binary file =\u003e [Release](https://github.com/go-musicfox/spotifox/releases/latest)\n\n### Windows\n\n#### 1. Scoop\n\n```sh\nscoop bucket add spotifox https://github.com/go-musicfox/spotifox.git\n\nscoop install spotifox\n```\n\n#### 2. Binary\n\nDownload binary file =\u003e [Release](https://github.com/go-musicfox/spotifox/releases/latest)\n\n### Manual Build\n\n```sh\n$ git clone https://github.com/go-musicfox/spotifox\n$ go mod download\n$ make\n$ make install\n```\n\n## Usage\n\n```sh\n$ spotifox\n```\n\n### Notice\n\n- **Please be sure to use a fixed width font or set the configuration item `dualColumn` to `false`, otherwise the dual column display layout may be confusing**\n\n\n### Shortcut keys\n\n|       Key        |               Effect               |    Remark    |\n|:----------------:|:----------------------------------:|:------------:|\n|   `h`/`H`/`←`    |             Move left              |              |\n|   `l`/`L`/`→`    |             Move right             |              |\n|   `k`/`K`/`↑`    |              Move up               |              |\n|   `j`/`J`/`↓`    |             Move down              |              |\n|       `g`        |            Move to top             |              |\n|       `G`        |           Move to bottom           |              |\n|     `q`/`Q`      |                Quit                |              |\n|     `Space`      |             Paly/Pause             |              |\n|       `[`        |              Pre song              |              |\n|       `]`        |             Next song              |              |\n|       `-`        |            Down volume             |              |\n|       `=`        |             Up volume              |              |\n| `n`/`N`/`Enter`  |             Enter menu             |              |\n| `b`/`B`/`Escape` |                Back                |              |\n|     `w`/`W`      |          Logout and quit           |              |\n|       `p`        |          Switch play mode          |              |\n|     `r`/`R`      |            Rerender UI             |              |\n|     `c`/`C`      |          Current Playlist          |              |\n|       `,`        |         Like playing song          |              |\n|       `\u003c`        |         Like selected song         |              |\n|       `.`        |        Dislike playing song        |              |\n|       `\u003e`        |       Dislike selected song        |              |\n|     `` ` ``      |    Add playing song to playlist    |              |\n|       `~`        | Remove playing song from playlist  |              |\n|      `Tab`       |   Add selected song to playlist    |              |\n|   `Shift+Tab`    | Remove selected song from playlist |              |\n|       `/`        |      Search current menu list      |              |\n|       `?`        |                Help                |              |\n|       `a`        |       Album of playing song        |              |\n|       `A`        |       Album of selected song       |              |\n|       `s`        |       Artist of playing song       |              |\n|       `S`        |      Artist of selected song       |              |\n|       `o`        |   Open playing song in brownser    |              |\n|       `O`        |   Open selected item in brownser   |              |\n|     `;`/`:`      |      Follow selected playlist      |              |\n|     `'`/`\"`      |     Unfollow selected playlist     |              |\n\n## Configuration\n\nConfiguration file path:\n\n```shell\nspotifox config\n```\n\n\u003e Set environment variables(`SPOTIFOX_ROOT`) to change the configuration file path\n\n[Sample](./utils/embed/spotifox.ini)\n\n\n## Similar Projects\n\n* [go-musicfox/go-musicfox](https://github.com/go-musicfox/go-musicfox)\n\n## Donate\n\n\u003ca href=\"https://www.buymeacoffee.com/anhoder\"\u003e\u003cimg src=\"https://img.buymeacoffee.com/button-api/?text=Buy me a coffee\u0026emoji=\u0026slug=anhoder\u0026button_colour=FFDD00\u0026font_colour=000000\u0026font_family=Comic\u0026outline_colour=000000\u0026coffee_colour=ffffff\" /\u003e\u003c/a\u003e\n\n## Thanks\n\nThanks to the following projects and their contributors (but not limited to):\n\n* [bubbletea](https://github.com/charmbracelet/bubbletea)\n* [beep](https://github.com/faiface/beep)\n* [musicbox](https://github.com/darknessomi/musicbox)\n* [gcli](https://github.com/gookit/gcli)\n* ...\n\n\n[![Star History Chart](https://api.star-history.com/svg?repos=go-musicfox/spotifox\u0026type=Date)](https://star-history.com/#go-musicfox/spotifox\u0026Date)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-musicfox%2Fspotifox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgo-musicfox%2Fspotifox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-musicfox%2Fspotifox/lists"}