spotifox

README

Spotify

English | 简体中文

Spotifox is yet another spotify CLI client similar to go-mousicfox.

UI base on charmbracelet/bubbletea

(The icon is based on kitty-icon)

---

Preview

1. Startup

2. MainUI

3. Notification

4. Login

5. Search

6. macOS NowPlaying

Install

macOS

1. Homebrew

$ brew install anhoder/go-musicfox/spotifox

2. Binary

Download binary file => Release

Linux

1. Homebrew

$ brew install anhoder/go-musicfox/spotifox

2. Binary

Download binary file => Release

Windows

1. Scoop

scoop bucket add spotifox https://github.com/go-musicfox/spotifox.git

scoop install spotifox

2. Binary

Download binary file => Release

Manual Build

$ git clone https://github.com/go-musicfox/spotifox
$ go mod download
$ make
$ make install

Usage

$ spotifox

Notice

• 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

Shortcut keys

Key	Effect	Remark
h/H/←	Move left
l/L/→	Move right
k/K/↑	Move up
j/J/↓	Move down
g	Move to top
G	Move to bottom
q/Q	Quit
Space	Paly/Pause
[	Pre song
]	Next song
-	Down volume
=	Up volume
n/N/Enter	Enter menu
b/B/Escape	Back
w/W	Logout and quit
p	Switch play mode
r/R	Rerender UI
c/C	Current Playlist
,	Like playing song
<	Like selected song
.	Dislike playing song
>	Dislike selected song
`	Add playing song to playlist
~	Remove playing song from playlist
Tab	Add selected song to playlist
Shift+Tab	Remove selected song from playlist
/	Search current menu list
?	Help
a	Album of playing song
A	Album of selected song
s	Artist of playing song
S	Artist of selected song
o	Open playing song in brownser
O	Open selected item in brownser
;/:	Follow selected playlist
'/"	Unfollow selected playlist

Configuration

Configuration file path:

spotifox config

Set environment variables(SPOTIFOX_ROOT) to change the configuration file path

Sample

Similar Projects

• go-musicfox/go-musicfox

Thanks

Thanks to the following projects and their contributors (but not limited to):

• bubbletea
• beep
• musicbox
• gcli
• ...