truemyst / beatprints

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

An amazing tool that generates eye-catching pinterest-style music posters ☕

BeatPrints is a tool designed to create eye-catching 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, set up the required environment variables in the .env file by creating it in the /BeatPrints directory. These variables include:

• SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET from Spotify for Developers
  • NOTE: (You need to create an app there with the scope being Web API, it's really easy)

1.4 Generating Posters

Navigate to the /BeatPrints directory and execute the following command:

$ python3 main.py

1.5 Features

For now BeatPrints offers these such features:

• Vintage Filters: Automatically enhances your posters to give it a classic look
• Multi-language Support: For now BeatPrints supports :
  • All English based languages, Hindi, Russian, Japanese, Chinese, Korean.
• Custom Image: Add a personalized touch by adding your own image as the cover
• Themes: Dark mode or Light mode? You have both of them
• Song Selection: Highlight your favorite track from your favorite artist
• Lyrics Selection: Feature lyrics that resonate with you

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 stumbled upon incredible music posters on Pinterest and was amazed by their uniqueness. Not finding a platform to create similar posters with appealing designs, I went out to develop a program that simplifies the process with just a few clicks and inputs. Surprisingly, the result exceeded my expectations.

• 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

beatprints's Issues

[Idea] Vintage Filters

Saw the plan about Vintage Filters in the readme.
Imho, might make sense to delegate it to Lutgen, if not nothing else, simply due to the sheer amount of work put into it.

Implementation for Apple music or Youtube Music API

I mean if there is a way to do it.

Some people might not use spotify or have a spotify account or preferably other software.

PyPI release?

This looks cool! Have you considered doing a PyPI release? Need any help with that?

cannot understand env file

i have no idea about what an env file is please help me and tell me how to get tthru the 2nd step in readme.md

Automatically crop the image into 1:1 ratio

Fix comma/period issues