Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/adambala/speech-bubble-it
Python script that puts a speech bubble on an image. Runs through the command line.
https://github.com/adambala/speech-bubble-it
image images meme memes pillow python python-script python3 speech-bubble
Last synced: about 2 months ago
JSON representation
Python script that puts a speech bubble on an image. Runs through the command line.
- Host: GitHub
- URL: https://github.com/adambala/speech-bubble-it
- Owner: adambala
- License: mit
- Created: 2024-01-12T16:11:06.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-01-28T22:16:17.000Z (12 months ago)
- Last Synced: 2024-01-28T23:25:36.485Z (12 months ago)
- Topics: image, images, meme, memes, pillow, python, python-script, python3, speech-bubble
- Language: Python
- Homepage:
- Size: 2.43 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Speech Bubble It
Speech Bubble It is a Python script that puts a speech bubble on an image.
## About
Online communication is accompanied by various jokes in the form of images (mostly memes). These also include speech bubbles.
The point of such images is that the sender presents the user in a chat as a character or a thing that speaks its message in a speech bubble.
## Example
./input/input.jpg |./output/output.png
:-----------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------:
 |
```sh
python speech_bubble_it.py .\input\input.jpg .\output\output.png
```
## Instructions
This script does not require large resources to create an image with a speech bubble. It requires `Python 3.10` or above and these dependencies:
- Pillow
You can install them by running `pip install -r requirements.txt`
Speech Bubble It can be used from the command line:
```sh
python speech_bubble_it.py
```
where
- `` is the path to an image you want to put speech bubble on;
- `` is the path to the file where the result will be written to.
The script supports such image formats as `.png`, `.jpg`, `.jpeg`, `.gif`, `.bmp`, `.webp` and `.tiff`.
## Optional arguments
You can transform your speech bubble by these flags:
- `-h`, `--help` — help information;
- `-m`, `--mirror` — flips speech bubble horizontally;
- `-o`, `--orientation` — changes speech bubble orientation (1: on the top; 2: on the left; 3: on the bottom; 4: on the right).
## Contributions
This repository is open for contributing. So feel free to open issues and make pull requests.
## TODO
- [ ] The support of images from web
- [ ] The support of GIF animations
- [ ] Vector image of the speech bubble instead of `.png`