1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
# tui-ascii-mapper
A terminal-based map editor for creating ASCII maps with Unicode symbols and ANSI 256-color support. It supports both keyboard and mouse. Built with [Bubble Tea](https://github.com/charmbracelet/bubbletea).
## Features
- **8 drawing tools**: Brush, Select, Erase, Fill (flood fill), Line, Rectangle, Circle, Text labels
- **30 built-in terrain types**: Or make your own. Choose multiple colors!
- **Unicode/ASCII toggle**: switch between Unicode symbols and ASCII fallbacks
- **256-color ANSI support**: built-in color picker to assign colors per terrain or text label
- **Submaps**: press enter to drill down into a sub-map (e.g. a town map)
- **Text labels**: place movable text strings on a layer above the map
- **Save/Load**: maps save in a custom YAML format, but have easy copy/paste
## Controls
### Keyboard
| Key | Action |
| ------------------------- | ------------------------------------------- |
| Arrow keys / h/j/k/l | Move cursor |
| Space / Enter | Use tool at cursor / move text / make shape |
| 0-9 | Select symbol |
| Shift + 1-8 | Select tool |
| - / = | Previous/next palette page |
| [ / ] | Decrease/increase brush width |
| f | Toggle fill shapes |
| u | Toggle Unicode/ASCII modes |
| c (in Text tool) | Open color picker for text label |
| e (in Text tool) | Edit text label at cursor |
| Esc | Cancel / go up 1 map level |
| Backspace / x | Erase cell / delete text label |
| arrow keys (in text drag) | Move dragged text label |
| u | Undo |
| r | Redo |
| s | Save map |
| q | Quit |
## Configuration
Edit `config.yaml` to customize terrain symbols, colors, keybindings, and default map size. The config is loaded from the directory next to the binary, or from `$XDG_CONFIG_HOME/tui-ascii-mapper/config.yaml`.
## Building
```bash
go build -o tui-ascii-mapper
./tui-ascii-mapper
```
# AI Disclosure
This is 100% unreviewed, vibe coded slop. I needed a TUI ASCII map-making tool and couldn't find one and threw this together quickly. It has bugs.
# License
0BSD. Do anything you want.
|
