<--Projects

Play That Song

Play That Song is a terminal-based MP3 player built with Python, utilizing pygame, curses, and mutagen. It features keyboard controls for playback, volume adjustment, seeking within tracks, shuffle, repeat modes, and a customizable text-based interface. The player can display song metadata and switch between music directories during runtime. Installation instructions are provided for Linux, macOS, and Windows.

Features

• Play, Pause, Stop your tracks with easy keyboard shortcuts.
• Repeat Modes: Repeat a single track, repeat the entire playlist, or turn off repeat.
• Shuffle Mode: Shuffle your playlist to play songs randomly.
• Seek Functionality: Move forward or backward within the track using arrow keys.
• Volume Control: Adjust the volume using up and down arrows.
• Change Music Folder: Quickly switch between different music directories from within the player.
• Displays Song Metadata: See the currently playing song’s title, artist, and album.
• Customizable Playlist View: Browse through your playlist with the current track highlighted.
• Curses Interface: A retro text-based interface that runs right in your terminal.

Screenshots

Home Page Folder Change

Installation

1. Clone the repository:

    git clone https://github.com/rajofearth/play-that-song.git
    cd play-that-song
   

2. Install the required dependencies:

   • For Linux/macOS:

     pip install -r requirements.txt
     pip install curses
     

   • For Windows:

     pip install -r requirements.txt
     pip install windows-curses
     

3. Run the player:

    python play_that_song.py
   

Usage

Controls

Key	Action
P	Play/Pause the current track
S	Stop the track
R	Toggle repeat mode (Off/One/All)
H	Toggle shuffle mode
N	Play the next track
B	Play the previous track
← / →	Seek backward/forward in track
↑ / ↓	Increase/Decrease volume
F	Change music folder
ESC	Cancel folder change
Q	Quit the player

Changing the Music Folder

1. Press F to change the music folder.
2. Type the path to your music folder (e.g., ~/Music/).
3. Press Enter to load the new folder or ESC to cancel.

Default Music Folder

• The player starts with a default music folder. You can set this path in the code or change it during runtime using the F key.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to submit issues, feature requests, or pull requests to improve this project.

Acknowledgments

• Built using pygame for audio handling.
• curses for the text-based terminal interface.
• mutagen for reading MP3 metadata.
• Special thanks to the Python and open-source community for making such projects possible.

Contact

For any questions, suggestions, or feedback, please reach out via GitHub Issues.