Skip to content

oudend/Spotititle2

Repository files navigation

Spotititle 2

GitHub License Next JS Tauri

Spotititle is a Tauri-based application designed to display realtime song lyrics in a subtitle window. It uses a SP DC token that allows the backend to fetch the current song playing and its corresponding lyrics. The app consists of two windows: one for configuring settings, and handling the SP DC token, and another to display the subtitles.

Spotititle 2 is a feature-complete upgrade of a C++ project called Spotititle.

Demo Home Settings

Table of Contents


Get the SP DC Token

To obtain the sp_dc token on chrome, follow these steps:

  1. Open an Incognito Window:

    • Go to Spotify Web and log in with your Spotify credentials.
  2. Open Developer Tools:

    • Right-click anywhere on the page and select Inspect, or press F12 to open the browser’s Developer Tools.
  3. Navigate to the Application Tab:

    • In the Developer Tools window, select the Application tab at the top.
  4. Locate the Cookie:

    • From the left sidebar, expand Storage > Cookies > open.spotify.com.
    • Look for a cookie named sp_dc.
  5. Copy the Token:

    • Right-click on the sp_dc cookie, then copy its value.
  6. Important:

    • Do not log out of Spotify in that window after copying the token. Logging out will invalidate the cookies.
  7. Close the Incognito Window:

    • Safely close the window once the token is copied.

Prerequisites

Ensure that you have the following installed:

You can install Tauri CLI by running:

cargo install tauri-cli

Installation

  1. Clone the repository:

    git clone https://github.com/oudend/Spotititle2.git
  2. Navigate to the project directory:

    cd spotititle
  3. Install the dependencies:

    Using npm:

    npm install

    Using yarn:

    yarn install

Development

To run the app in development mode:

npx tauri dev

This will start the development server with hot reloading for the React components and the Tauri app.

Build

To build the app for production:

npx tauri build

The build artifacts will be generated in the src-tauri/target/release/ directory.

Usage

You can download the latest version of Spotititle from the Releases page.

  1. Launch the app.
  2. In the Main Window, input your SP DC token.
  3. Once authenticated, the app will start displaying the current song and lyrics in the Subtitles Window.

Directory Structure

.
├── src/                   # React app source code
├── src-tauri/             # Tauri-related files
│   ├── src/               # Rust source code for Tauri app
│   ├── tauri.conf.json    # Tauri configuration
├── public/                # Static assets for the React app
└── README.md              # Project documentation

Contributing

Contributions are welcome! To contribute:

  1. Fork the repository.
  2. Create a new branch for your feature/bugfix.
  3. Commit your changes and push the branch to your fork.
  4. Open a pull request.

Before Submitting a Pull Request:

  • Run the project locally to test your changes.

License

This project is licensed under the Mozilla Public License Version 2.0 License. See the LICENSE file for more details.

Contact

If you have any questions, feel free to open an issue or contact me on Discord: @oudend.

"Buy Me A Coffee"

About

tauri-based realtime subtitles for spotify

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors