Skip to content

Commit 0f80e97

Browse files
committed
Update README.md
1 parent 8887847 commit 0f80e97

File tree

1 file changed

+52
-2
lines changed

1 file changed

+52
-2
lines changed

README.md

Lines changed: 52 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,52 @@
1-
# get_stick_bugged_lol
2-
A python package and command-line tool that generates a 'get stick bugged' video from an image.
1+
# get-stick-bugged-lol
2+
A Python module and command-line tool that generates a
3+
[Get Stick Bugged Lol](https://knowyourmeme.com/memes/get-stick-bugged-lol) video from any image.
4+
5+
This script uses [pylsd-nova](https://github.com/AndranikSargsyan/pylsd-nova) to detect line segments in the image,
6+
Pillow to draw the lines as they move to form the stick bug, and MoviePy to create the video.
7+
8+
## Installation
9+
This package can be installed using pip:
10+
```
11+
pip install get-stick-bugged-lol
12+
```
13+
14+
## Usage
15+
#### In the terminal
16+
Installing the package will register the `gsbl` command in the terminal. To use the image `input.png` to generate the
17+
video `output.mp4`:
18+
```
19+
gsbl input.png output.mp4
20+
```
21+
Optional arguments:
22+
* `-h, --help` Display the help message and exit
23+
* `--line-color R G B` RGB color to use for line segments (default: 255 255 211)
24+
* `--bg-color R G B` RGB color to use for background after image disappears (default: 125 115 119)
25+
26+
More options will be added in later releases.
27+
28+
#### In a Python script
29+
30+
```python
31+
import gsbl
32+
33+
# generate the video from input.png
34+
video = gsbl.generate_stick_bug('input.png')
35+
36+
# save the video as output.mp4
37+
gsbl.save_video(video, 'output.mp4')
38+
```
39+
40+
## TODO
41+
* Rewrite to be more object-oriented and easier to maintain
42+
* Add more customization options, especially with the line detection and video resolution
43+
* Make a GUI
44+
45+
## License
46+
This package is available under the MIT License. See [LICENSE](LICENSE) for more info.
47+
48+
This package makes use of the following external libraries:
49+
* [pylsd-nova](https://github.com/AndranikSargsyan/pylsd-nova)
50+
* [NumPy](https://numpy.org)
51+
* [Pillow](https://python-pillow.org)
52+
* [MoviePy](https://github.com/Zulko/moviepy)

0 commit comments

Comments
 (0)