TrueMyst/BeatPrints

☕ BeatPrints, a tool that generates eye-catching pinterest-style music posters in python

BeatPrints: Quick, stylish posters for your favorite tracks! 🎷☕️

A tool designed to create eye-catching Pinterest-style music posters that stand out. It provides a straightforward way to generate custom posters using Spotify and LRClib API. 🍀

📜 Getting Started

1.1 Installation

Clone this repository into your preferred directory using Git:

git clone --depth 1 https://github.com/TrueMyst/BeatPrints.git && cd BeatPrints

1.2 Dependencies

Install the necessary dependencies using pip:

$ pip install -r requirements.txt

This ensures all required packages are installed to run the project smoothly.

1.3 Environment Variables

To run this project, you need to create a .env file to set up the required environmental variables. These include:

• SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET, which can be obtained from Spotify for Developers.

Note

Make sure you select Web API as the scope of the application.

You can find an example .env file here. Rename this file to .env and use it as needed.

1.4 Generating Posters

Navigate to the cli directory and execute the following command:

$ python3 prompt.py

Important

KeyError: 'setting text direction, language or font features is not supported without libraqm'.

If you're on Windows, you may encounter this problem. You can resolve this issue, by installing fribidi.dll for Pillow to handle complicated texts. Download the required file from here and place it in the following directory: C:\Program Files\Python312\

If you're on macOS, you can fix this issue by running these commands:

pip3 uninstall Pillow
pip3 install Pillow --global-option="build_ext" --config-settings="-I = /opt/homebrew/Cellar"

1.5 Current Features

For now BeatPrints offers these such features:

• Polaroid Filter: Enhance cover pictures with a classic look.
• Multi-language Support: English, Hindi, Russian, Japanese, Chinese, Korean.
• Custom Image: Personalize with your own cover image.
• Themes: Choose between Dark mode and Light mode.
• Song Selection: Highlight your favorite track.
• Lyrics Selection: Feature meaningful lyrics.

More features are yet to come :)

1.6 We got more samples!

If you're looking for more samples, no worries—we've got you covered. Head to the examples directory to find additional posters available for viewing.

🤝 Contributing

Contributions to BeatPrints are welcome. Feel free to submit your suggestions via pull requests. Your contributions are invaluable in enhancing this tool for everyone.

💡 Inspiration & Gratitude

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, and I believe my posters are simpler, cleaner, and prettier.

• Thanks to Spotify Poster Generator by @AnveshakR for a good amount of ideas!
• A big shoutout to @Magniquick & @Krishna-Gunjan for their big contributions!
• And a heartfelt thank you to @T-Dynamos and @cherriae for their significant improvements to BeatPrints.

📋 About License

BeatPrints is released under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License, which grants the following permissions:

• Use: Copy, share, and adapt the material.
• Attribution: Provide appropriate credit to the owner and a link to the license.
• NonCommercial: Don't use it for commercial purposes.
• ShareAlike: Share adaptations under the same license.
• No Additional Restrictions: Don't impose extra legal or technological limitations.

For more detailed information, please check out the LICENSE

Made with 💜
elysianmyst, 2024