SpoTwiPy-Shuffle!

Amazing project where I challenge myself to do a python app with javascript vanilla interactions. Check the working project here
Explore the docs »

Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgements

About The Project

Check this page to see the project working!

In this project I callenged myself to do a flask-app, with spotify API and Twitter API, what this does is to grab, from my top listened songs from spotify, 5 random songs and automatically tweet their names on my Twitter account. That is all, but here are the rules:

• You can not choose explicitly what song you want to tweet, but you can push a button over a song to replace it for another randomly selected song (always from your top listened songs).
• You can alter the tweet content, that is not fun at all, but exists the possibility to run out of characters for a proper tweet, so you can control what the tweet says.

Here's why:

I love to develop and create new projects everyday, this little bot is essencially just a project to improve my HTML, CSS, Python, JS, API skills ;)

Built With

• Flask
• Spotify API
• Tweepy
• SASS

Getting Started

To get a local copy up follow these simple steps.

1. Go to your terminal and travel where you want to save this project, in my case will be in a Dev folder.

cd Dev/

2. Now create a clone of this repository with

git clone https://github.com/BubuDavid/SpoTwipy.git

3. You are almost there, lets go for the prerequisites.

Prerequisites

You will need this on your computer

• Python 3.6+
• Pip (Compatible with python 3.6+)
• venv or your own environment creator
• A Spotify Develop account, these are free here.
• A Twitter Develop account, this is harder but you can create one in here

Installation

1. Crate a spotify app and save the client id and the client secret in a .env file inside your folder. Notice you have to save this things with the appropiate names as they appear in the app.py file. Notice you have to save a SPOTIFY_CALLBACK_URI, that is you callback url, I recomend you to just write http://localhost:8888/spotify-callback in your .env and in your app in the section of callback uri.
2. Create a twitter app almost identically as the spotify app but save all the keys they give to you, you will not be able to retrieve those keys if you lose them, you will have to re-generate them if this happens.
3. You have to create a env variable in the .env called SECRET_KEY and it can contain anything you want.
4. Now you only have to go into your terminal, get into your root folder (not the Dev folder, the repository folder), and write

pip install -r requirements.txt

If everything worked out, then you are ready to shuffle ittt yourself.

Usage

You just need to run

python app.py

and voila! Your server is ready and running, just go to your web browser to this direction http://localhost:8888/. The following steps are pretty straightforward.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

David, but you can call me Bubu - @DBubu73 - david.pedroza.segoviano@gmail.com

Project Link: SpoTwipy

Acknowledgements

• Best Readme Template
• StackOverflow
• Font Awesome