[](LICENSE) [](https://github.com/AvinashReddy3108/spicetify-tui/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) [](https://github.com/AvinashReddy3108)
Table of Contents
- [About](#about) - [Getting Started](#getting-started) - [Prerequisites](#prerequisites) - [Installation](#installation) - [Customization](#customization) - [Roadmap](#roadmap) - [Support](#support) - [Project assistance](#project-assistance) - [Contributing](#contributing) - [Authors & contributors](#authors--contributors) - [Security](#security) - [License](#license) - [Acknowledgements](#acknowledgements)About
A @spicetify theme that aims to mimic the look of spotify-tui.
Screenshots
|
| 
| 
|
|:---------------------------------------------------------------------:|:---------------------------------------------------------------------:|:---------------------------------------------------------------------:|
| Spotify | Spicetify | Dracula |
| 
| 
| 
|
| Catppuccin Mocha | Catppuccin Macchiato | Catppuccin Latte |
| 
| 
| 
|
| Gruvbox | Kanagawa | Nord |
| 
| 
| 
|
| Rigel | Rose Pine | Rose Pine Moon |
| 
| 
| 
|
| Solarized | Tokyo Night | Tokyo Night Storm |
Getting Started
Prerequisites
- Spotify Desktop: Windows | Linux
- Spicetify: Installation -> Set up for first time use
Installation
Automated installation
For Windows (Powershell): ```ps1 iwr -useb 'https://raw.githubusercontent.com/AvinashReddy3108/spicetify-tui/master/install.ps1' | iex ``` For Linux/macOS (Bash): ```sh curl -fsSL 'https://raw.githubusercontent.com/AvinashReddy3108/spicetify-tui/master/install.sh' | sh ```
Add the following to your config-xpui.ini file. Details as to why are explained here.
[Patch]
xpui.js_find_8008 = ,(\w+=)56,
xpui.js_repl_8008 = ,${1}32,Customization
Display Images
Open `user.css` with a code editor like Notepad++/VSCode, and under the `:root`: ```css --display-card-image: block; --display-coverart-image: block; --display-header-image: block; --display-library-image: block; --display-tracklist-image: block; ``` 
Remove Images (for the realistic TUI look)
Open `user.css` with a code editor like Notepad++/VSCode, and under the `:root`: ```css --display-card-image: none; --display-coverart-image: none; --display-header-image: none; --display-library-image: none; --display-tracklist-image: none; ``` 
[Windows] Make the window controls' background match with the topbar background
Open `user.css` with a code editor like Notepad++/VSCode, and append this snippet: ```css /* transparent window controls background */ body::after { content: ""; position: absolute; right: 0; z-index: 999; backdrop-filter: brightness(2.12); /* page zoom [ctrl][+] or [ctrl][-] edit width and height accordingly 69% = 194px 45px 76% = 177px 40.5px 83% = 162px 37.5px 91% = 148px 34px 100% = 135px 31px (default) 110% = 123px 28.5px */ width: 135px; height: 31px; } ``` 
Roadmap
See the open issues for a list of proposed features (and known issues).
- Top Feature Requests (Add your votes using the 👍 reaction)
- Top Bugs (Add your votes using the 👍 reaction)
- Newest Bugs
Support
Reach out to the maintainer at one of the following places:
- GitHub issues
- Contact options listed on this GitHub profile
Project assistance
If you want to say thank you or/and support active development of spicetify-tui:
- Add a GitHub Star to the project.
- Write interesting articles about the project on Dev.to, Medium or your personal blog.
Together, we can make spicetify-tui better!
Contributing
First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.
Please read our contribution guidelines, and thank you for being involved!
Authors & contributors
The original setup of this repository is by Avinash Reddy.
For a full list of all authors and contributors, see the contributors page.
Security
spicetify-tui follows good practices of security (where applicable), but 100% security cannot be assured. spicetify-tui is provided "as is" without any warranty. Use at your own risk.
For more information and to report security issues, please refer to our security documentation.
License
This project is licensed under the MIT license.
See LICENSE for more information.
Acknowledgements
- text theme for spicetify, by @darkthemer: Initial bringup
- Amazing GitHub Template, by @dec0dOS: README.md template (and supporting files)