StreamScape is a Terminal User Interface (TUI) application for managing and streaming web radio stations. With an intuitive interface and customizable playlists, StreamScape brings the world of online radio to your terminal.
- Playlist Management: Create, edit, and switch between multiple playlists.
- Last Station Resume: Automatically save the last played station and resume it after restarting the app.
- Stream Monitoring: Tracks playback status to ensure smooth streaming.
- Search and Filter: Easily find your favorite stations with search functionality.
- Minimal Dependencies: Works with
ffplayandcurlfor streamlined performance.
-
Ensure you have the required dependencies installed:
ffmpegcurl- Python 3.x (with
requestsmodule installed)
-
Clone the repository:
git clone https://github.com/1999AZZAR/streamscape.git cd streamscape -
Run the application:
python radio.py
- Navigate pages:
</> - Next/Previous station:
n/p - Jump to specific station:
j - Search stations:
/ [search term] - Clear search:
c
- Switch playlists:
s - Add a station:
a - Delete a station:
d
- Show help menu:
h - Exit application:
e
StreamScape saves your last played station in the configuration file and prompts you to resume playback on the next startup.
Easily manage your stations using the intuitive menu. Add new stations, delete old ones, or switch playlists effortlessly.
StreamScape stores user preferences in radio_config.json. The file includes:
current_playlist: Tracks the currently active playlist.last_played_station: Saves the last played station details.
We welcome contributions! Feel free to fork the repository, create a branch, and submit a pull request. Please ensure your code adheres to the project's guidelines.
StreamScape is licensed under the MIT License. See the LICENSE file for more details.
For issues or feature requests, please open an issue on the GitHub repository or reach out to the maintainers.
Enjoy your personalized radio streaming experience with StreamScape!