Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/esimov/diagram
CLI app to convert ASCII arts into hand drawn diagrams.
https://github.com/esimov/diagram
ascii ascii-art canvas cli diagram drawing go gocui golang termbox-go terminal
Last synced: 8 days ago
JSON representation
CLI app to convert ASCII arts into hand drawn diagrams.
- Host: GitHub
- URL: https://github.com/esimov/diagram
- Owner: esimov
- License: mit
- Created: 2017-08-02T12:14:38.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-10-20T07:50:08.000Z (about 1 year ago)
- Last Synced: 2024-05-22T18:32:36.616Z (6 months ago)
- Topics: ascii, ascii-art, canvas, cli, diagram, drawing, go, gocui, golang, termbox-go, terminal
- Language: Go
- Homepage:
- Size: 6.04 MB
- Stars: 819
- Watchers: 16
- Forks: 32
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-golang-repositories - diagram
README
# Diagram
[](https://pkg.go.dev/github.com/esimov/diagram)
[](https://github.com/esimov/diagram/actions/workflows/build.yml)
[](https://goreportcard.com/report/github.com/esimov/diagram)
[](./LICENSE)
Diagram is a small CLI application to generate hand drawn diagrams from ASCII art.
## Installation
In order to run the application please make sure that Go is installed on your local machine and check if `$GOPATH/bin` is included into the `PATH` directory.
Run the following commands to download the project and build the executable.
```bash
$ git clone https://github.com/esimov/diagram
$ cd diagram
$ go build
# Start the application
$ diagram
```
#### Build
A shell script is bundled into the library to mitigate the generation of binary files for the most known operating systems, but take care: different dependencies are needed for different operating systems. To build the executable file run:
`$ make all`
## Usage
Once you are inside the terminal application you can create, edit or delete the ASCII diagrams. By pressing `CTRL+d` you can convert the ASCII art into a handwritten diagram. The generated `PNG` file will be saved into the `output` folder relative to the current path.
### Command Line support
The application also supports the generation of hand drawn diagrams directly from command line without to enter into the CLI application.
`$ diagram --help` will show the currently supported options:
```bash
┌┬┐┬┌─┐┌─┐┬─┐┌─┐┌┬┐
│││├─┤│ ┬├┬┘├─┤│││
─┴┘┴┴ ┴└─┘┴└─┴ ┴┴ ┴
Version: 1.0.4
CLI app to convert ASCII arts into hand drawn diagrams.
-font string
Path to the font file (default "/Users/esimov/Projects/Go/src/github.com/esimov/diagram/font/gloriahallelujah.ttf")
-in string
Source
-out string
Destination
-preview
Show the preview window (default true)
```
#### CLI Examples
Read input from `sample.txt` and write image to `sample.png` showing a preview window with the hand drawn diagram:
```bash
diagram -in sample.txt -out sample.png
```
Read input from `sample.txt` and write image to `sample.png`, and exit immediately without showing a preview window:
```bash
diagram -in sample.txt -out sample.png -preview=false
```
Generate diagram as above but use a font at a different location:
```bash
diagram -in sample.txt -out sample.png -preview=false -font /path/to/my/font/MyHandwriting.ttf
```
### Key bindings
Key | Action
----------------------------------------|---------------------------------------
Tab | Next Panel
Shift+Tab | Previous Panel
Ctrl+s | Open Save Diagram Modal
Ctrl+s | Save Diagram
Ctrl+d | Convert Ascii to PNG
Ctrl+x | Clear the editor content
Ctrl+z | Restore the editor content
PageUp | Jump to the top
PageDown | Jump to the bottom
Home | Jump to the line start
End | Jump to the line end
Delete/Backspace | Delete diagram
Ctrl+c | Quit
### Example
| Input | Output |
|:--:|:--:|
| 
| 
|
The application was tested on **Ubuntu**, **MacOS** and **Windows**.
### Acknowledgements
The ASCII to PNG conversion was ported from [shaky.dart](https://github.com/mraleph/moe-js/blob/master/talks/jsconfeu2012/tools/shaky/web/shaky.dart).
## Dependencies
- https://github.com/jroimartin/gocui
- https://github.com/fogleman/gg
- https://gioui.org/
## Author
* Endre Simo ([@simo_endre](https://twitter.com/simo_endre))
## License
Copyright © 2017 Endre Simo
This project is under the MIT License. See the [LICENSE](https://github.com/esimov/diagram/blob/master/LICENSE) file for the full license text.