Skip to content

Commit 6e0b96c

Browse files
committed
Move all images into images/ directory
Clean up repo root — 16 PNGs moved out of the top level.
1 parent a2738e2 commit 6e0b96c

18 files changed

+17
-22
lines changed

.gitignore

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -175,9 +175,4 @@ docs/
175175
*.png
176176
*.jpg
177177
*.jpeg
178-
!ascii_preview.png
179-
!ascii_logo_preview.png
180-
!charset_*.png
181-
!width_*.png
182-
!logo_example.png
183-
!logo_photo_mode.png
178+
!images/

README.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
MCP server for converting images to ASCII art.
44

5-
![Photo mode — NASA astronaut rendered as hi-fi colored ASCII art](ascii_preview.png)
5+
![Photo mode — NASA astronaut rendered as hi-fi colored ASCII art](images/ascii_preview.png)
66

77
> 200 chars wide, `classic` charset (70 tonal levels), hi-fi color — every character is a pixel.
88
@@ -16,15 +16,15 @@ Two modes — **photo** and **logo** — with smart defaults for each.
1616
| **Invert** | Off | Auto-detects light backgrounds |
1717
| **Alpha** | Composites on white | Composites on black |
1818

19-
![Logo mode — horse silhouette as ASCII art](ascii_logo_preview.png)
19+
![Logo mode — horse silhouette as ASCII art](images/ascii_logo_preview.png)
2020

2121
### How Logo Mode Works
2222

2323
Logo mode is designed for images with a clear subject on a uniform background — logos, text, icons, silhouettes.
2424

2525
Here's a black-and-white "ASCII_MCP" text image run through **logo mode**:
2626

27-
![Logo mode — ASCII_MCP text](logo_example.png)
27+
![Logo mode — ASCII_MCP text](images/logo_example.png)
2828

2929
What logo mode does automatically:
3030
1. **Detects the light background** by sampling the corners of the image
@@ -34,7 +34,7 @@ What logo mode does automatically:
3434

3535
Compare with the same image in **photo mode** (wrong mode for this):
3636

37-
![Photo mode on a logo — ░ fill makes it muddy](logo_photo_mode.png)
37+
![Photo mode on a logo — ░ fill makes it muddy](images/logo_photo_mode.png)
3838

3939
Photo mode fills every empty pixel with ``, which destroys the negative space that defines the logo. That's why mode matters.
4040

@@ -99,49 +99,49 @@ Each charset maps pixel brightness to a different set of characters. The number
9999

100100
`@%#*+=-:. ` — balanced between detail and readability. Works for both photos and logos.
101101

102-
![detailed charset](charset_detailed.png)
102+
![detailed charset](images/charset_detailed.png)
103103

104104
### `classic` — 70 levels, maximum tonal range
105105

106106
`$@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/\|()1{}[]?-_+~<>i!lI;:,"^'. ` — the most detailed charset. Every subtle gradient gets its own character. Best for photos where you want maximum fidelity.
107107

108-
![classic charset](charset_classic.png)
108+
![classic charset](images/charset_classic.png)
109109

110110
### `simple` — 9 levels, Unicode block shading
111111

112112
`█▉▊▋▌▍▎▏ ` — smooth, print-like appearance using Unicode block elements. Looks like a halftone print.
113113

114-
![simple charset](charset_simple.png)
114+
![simple charset](images/charset_simple.png)
115115

116116
### `blocks`~4 levels, coarse block shading
117117

118118
`██▓▒░ ` — bold, high-contrast look. Good for logos and silhouettes where you want punch over detail.
119119

120-
![blocks charset](charset_blocks.png)
120+
![blocks charset](images/charset_blocks.png)
121121

122122
### `minimal` — 3 levels, binary
123123

124124
`■□ ` — just solid, outline, and empty. Crispest edges, no gradients. Best for logos and icons.
125125

126-
![minimal charset](charset_minimal.png)
126+
![minimal charset](images/charset_minimal.png)
127127

128128
### `hifi`~9 levels, fine gradation
129129

130130
Repeated characters (`@@@###***+++===---:::...`) create smooth tonal bands. Good for photos.
131131

132-
![hifi charset](charset_hifi.png)
132+
![hifi charset](images/charset_hifi.png)
133133

134134
### `dense`~4 levels, heavy block shading
135135

136136
Heavy Unicode blocks — bold, poster-like look.
137137

138-
![dense charset](charset_dense.png)
138+
![dense charset](images/charset_dense.png)
139139

140140
### `ultra`~9 levels, balanced ASCII
141141

142142
Repeated ASCII characters (`@@@###***+++===---:::...`) — like `hifi` but pure ASCII, no Unicode.
143143

144-
![ultra charset](charset_ultra.png)
144+
![ultra charset](images/charset_ultra.png)
145145

146146
## Choosing a Width
147147

@@ -155,16 +155,16 @@ The `width` parameter controls how many characters wide the output is. More char
155155
| 200 | Maximum detail | Near-photographic |
156156

157157
### Width 40
158-
![width 40](width_40.png)
158+
![width 40](images/width_40.png)
159159

160160
### Width 80 (default)
161-
![width 80](width_80.png)
161+
![width 80](images/width_80.png)
162162

163163
### Width 120
164-
![width 120](width_120.png)
164+
![width 120](images/width_120.png)
165165

166166
### Width 200
167-
![width 200](width_200.png)
167+
![width 200](images/width_200.png)
168168

169169
**Rule of thumb:** match `width` to where the output will be displayed. Terminal? Use 80-120. Discord message? Use 40-60. Saving to a file? Go big with 160-200.
170170

0 commit comments

Comments
 (0)