Get a dynamically generated GIF with a game overlay on your README!
Readme As GIF is a web application that creates personalized GIFs with a game overlay. Users can specify some information about them to generate personalized texts, select their most used technology icons and select the game that appear in the GIF.
To use Readme As GIF, follow these simple steps:
-
Access the Website:
- Go to the Readme As GIF website at:
-
Base Image:
- On the website, locate the form.
- Customize the form according to your preferences.
- Click the 'Generate' button to create the base image.
-
Game Selection:
- Once the base image is generated, choose the desired game overlay.
- Click the 'Next' button to access game options.
-
Game Customization:
- Fill in the relevant game options as before.
- Click 'Generate' to combine your selections.
-
Outcome Evaluation:
- If you're satisfied with the result, click 'Download' to obtain the GIF.
- If the outcome isn't what you wanted, don't worry! Just click 'Cancel' and modify the base image.
-
Putting it in Your Readme:
- Once the GIF file is downloaded, you can easily integrate it into your README by dragging and dropping.
That's it! With these steps, you can effortlessly create customized GIFs tailored to your preferences. Enjoy the creative process!
Note
If you're aiming to generate high-resolution GIFs or GIFs with longer durations, you might encounter limitations on Vercel's platform. In such cases, I recommend building this repository locally to overcome these limits.
Follow these steps to set up and build the Readme As GIF project on your local machine:
-
Clone the Repository:
- Clone this repository to your computer using GitHub CLI or download it as a ZIP archive.
-
Navigate to the Project Directory:
- Depending on your operating system:
- On Linux: Open the terminal application and use the
cd
command to navigate to the destination folder.cd path/to/destination_folder
- On Windows:
- Press
Windows + R
, typecmd
, and press Enter. - Use the
cd
command to navigate to the folder where you extracted the project. For example:cd path\to\destination_folder
- Press
- On Linux: Open the terminal application and use the
- Depending on your operating system:
-
Create a Python Virtual Environment:
- Set up a Python virtual environment using the following command:
python -m venv venv
- Set up a Python virtual environment using the following command:
-
Activate the Python Virtual Environment:
- Activate the Python virtual environment:
- On Linux:
source venv/bin/activate
- On Windows:
venv\Scripts\activate
- On Linux:
- Activate the Python virtual environment:
-
Install Project Requirements:
- Install the required dependencies using pip and the provided
requirements.txt
file:pip install -r requirements.txt
- Install the required dependencies using pip and the provided
-
Set Flask App Location:
- Export the location of
app.py
for Flask:export FLASK_APP=api/app.py
- Export the location of
-
Run the Application:
- Launch the application using the Flask development server:
flask run
- Launch the application using the Flask development server:
-
Access the Application:
- Open your web browser and enter the following URL:
https://127.0.0.1:5000/
- Open your web browser and enter the following URL:
If you find any bugs, have suggestions for improvements, or want to add new features, feel free to open an issue or submit a pull request.
Before making significant changes, please discuss them to ensure they align with the project's goals and direction.
The Readme As GIF is released under the MIT License. You are free to use, modify, and distribute the code as per the terms of the license.