You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-8Lines changed: 11 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,19 +7,21 @@
7
7
8
8
## 📜 Overview
9
9
10
-
**ASCII Generator** is a Python tool that transforms **images** and **videos** into ASCII art in real time or as static output.
10
+
**ASCII Generator** is a modular-oriented Python engine that converts images, videos, and live camera feeds into expressive ASCII art. Use it for real-time terminal previews or export results as text, images, or video.
11
+
12
+
Designed for flexibility and ease of use, the project provides configurable character sets, color and grayscale modes, adjustable density/contrast, and persistent settings for reproducible output.
<em>Interactive terminal interface with real-time preview</em>
16
18
</p>
17
19
18
20
## 🛠️ Things to fix / improve
19
21
20
-
-**[*] Fix video speed synchronization issues**: the video FPS detection was causing desync between video playback and ASCII rendering speed.
21
-
-**[*] View problems with sizing videos on exporting to file:** only change the aspect ratio, it's recommended the default settings be used for best results. (0.50f)
22
-
-[ ] Implement logger for debugging
22
+
-**[x] Fix video speed synchronization issues**: the video FPS detection was causing desync between video playback and ASCII rendering speed.
23
+
-**[x] View problems with sizing videos on exporting to file:** only change the aspect ratio, it's recommended the default settings be used for best results. (0.50f)
24
+
-**[x] Implement logger for debugging**
23
25
-[ ] Optimize performance for higher resolutions
24
26
-[ ] Add custom character sets and styles
25
27
@@ -42,6 +44,7 @@
42
44
- Persistent user settings (saved between sessions in `config.json`)
43
45
- Clean modular architecture — easy to extend
44
46
- Windows-friendly (includes `run.bat` launcher)
47
+
- Export ASCII art to **text** files or **images/videos**
45
48
46
49
## 🚀 Installation
47
50
@@ -65,7 +68,7 @@ pip install -r requirements.txt
65
68
Launch the application:
66
69
67
70
```cmd
68
-
python src/app.py
71
+
python src/main.py
69
72
```
70
73
71
74
Alternatively (**Windows** users):
@@ -82,7 +85,7 @@ Once running you can:
82
85
83
86
## 📦 Dependencies
84
87
85
-
Listed in `requirements.txt` </br>
88
+
Listed in `requirements.txt`.
86
89
Main libraries include:
87
90
88
91
-`opencv-python` — image/video processing
@@ -108,7 +111,7 @@ We appreciate your contributions and feedback! 🙌
108
111
109
112
## 📝 License
110
113
111
-
MFOG is licensed under the MIT License.
114
+
ASCII Generator is licensed under the MIT License.
0 commit comments