BeatPrints
☕ BeatPrints, create eye-catching, Pinterest-style music posters effortlessly.
Install / Use
/learn @TrueMyst/BeatPrintsREADME
📦 Installation
You can install BeatPrints via:
# For pip users
pip install BeatPrints
# For poetry users
poetry add BeatPrints
Or if you prefer using just the CLI:
pipx install BeatPrints
This will install the CLI, making it ready for you to use. For more more infomation, check out pipx
🚀 Quick Start
🌱 Environment Variables
To get started with BeatPrints, you’ll need a .env file with these keys:
SPOTIFY_CLIENT_ID = "<your-client-id>"
SPOTIFY_CLIENT_SECRET = "<your-client-secret>"
You can get these from the Spotify Developer Dashboard by creating a new app with Web API as the scope.
🎀 Creating your FIRST Poster
Here’s how you can create your first poster:
import os, dotenv
from BeatPrints import lyrics, poster, spotify
dotenv.load_dotenv()
# Spotify credentials
CLIENT_ID = os.getenv("SPOTIFY_CLIENT_ID")
CLIENT_SECRET = os.getenv("SPOTIFY_CLIENT_SECRET")
# Initialize components
ly = lyrics.Lyrics()
ps = poster.Poster("./")
sp = spotify.Spotify(CLIENT_ID, CLIENT_SECRET)
# Search for the track and fetch metadata
search = sp.get_track("Saturn - SZA", limit=1)
# Pick the first result
metadata = search[0]
# Get lyrics and determine if the track is instrumental
lyrics = ly.get_lyrics(metadata)
# Use the placeholder for instrumental tracks; otherwise, select specific lines
highlighted_lyrics = (
lyrics if ly.check_instrumental(metadata) else ly.select_lines(lyrics, "5-9")
)
# Generate the track poster
ps.track(metadata, highlighted_lyrics)
🥞 CLI
Here’s a short video showing how to generate posters using the CLI. For more information refer to the documentation here
https://github.com/user-attachments/assets/3efb7028-c533-4bf4-880b-da3a71f8a3db
🖼️ Examples
| Track: Saturn by SZA | Album: Charm by Clairo |
| -------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| 
| 
|
🎨 Themes
BeatPrints currently offers you 5 additional themes to use!
- Catppuccin
- Gruvbox
- Nord
- Rosepine
- Everforest
For more examples, check out the examples directory.
✨ Features
- Polaroid Filter for Covers: Give your track or album covers a vintage Polaroid look.
- Multi-language Support: Supports English, Hindi, Russian, Japanese, Chinese, and Korean.
- Custom Cover Images: Personalize posters with your own images.
- Theme Customization: Switch between different other themes.
- Track & Album Selection: Highlight your favorite track or entire album.
- Lyrics Highlighting: Highlight your favourite lyrics directly on your poster.
🤝 Contributors
Thank you to all contributors for making BeatPrints better!
<p align="center"> <a href="https://github.com/TrueMyst/BeatPrints/graphs/contributors"> <img src="https://contrib.rocks/image?repo=TrueMyst/BeatPrints" /> </a> </p>💡 Why BeatPrints?
I created this project after finding out that people sell these posters on Etsy at high prices, offering only digital downloads instead of shipping actual posters.
I wanted to make it free for everyone to print themselves, as I believe my posters are simpler, cleaner, and prettier.
❤️ Special Thanks
- A big thanks to Spotify Poster Generator by @AnveshakR for inspiring BeatPrints with amazing ideas!
- Shoutout to @Magniquick, @itsnotrin, @wenbang24 and @cherriae for their awesome contributions!
📜 License
BeatPrints is distributed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License:
- Use: Free to share and adapt.
- Attribution: Provide credit and a link to the license.
- NonCommercial: Not for commercial use.
- ShareAlike: Adaptations must follow the same license.
Read the full license here.
<p align="center"> Made with 💜 <br> elysianmyst, 2025 </p>