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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
neetdraw
========
'neetdraw' is a terminal drawing application with multiplayer support.
image::neetdraw.png[align="center"]
Packages
--------
Regular releases are sporadic. git master should be stable enough.
You can get a package with the latest development version using Arch Linux's
https://aur.archlinux.org/packages/neetdraw-git[AUR],
or as a https://git.janouch.name/p/nixexprs[Nix derivation].
Building
--------
Build dependencies: CMake, pkg-config, liberty (included), termo (included) +
Runtime dependencies: ncursesw, libev
$ git clone --recursive https://git.janouch.name/p/neetdraw.git
$ mkdir neetdraw/build
$ cd neetdraw/build
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug
$ make
To install the application, you can do either the usual:
# make install
Or you can try telling CMake to make a package for you. For Debian it is:
$ cpack -G DEB
# dpkg -i neetdraw-*.deb
Usage
-----
For standalone mode you can run the program without arguments:
$ neetdraw
To run as a server for other clients to connect to and draw simultaneously:
$ neetdraw -s :1234
To connect to a running server, run:
$ neetdraw -c localhost:1234
Once you have the program running, simply select a colour you like from the
palette and draw by pressing and dragging the mouse. Use the middle mouse
button to move the canvas.
You can store the current image to `drawing.bin` and load it back using the
's' and 'l' keys respectively. To just export the current picture for printing
it on a terminal, press 'e'. To export for IRC, press 'E'.
Known Issues
------------
VTE-based terminals, such as gnome-terminal, are terminally broken and you will
experience drawing artefacts. Those are neither a problem of this application,
nor a problem of ncurses as far as I can tell.
To achieve the best results, please use a decent terminal such as rxvt-unicode
or xterm. These two are feature-full and *fast*. st also works great.
Even so, try not to strain the application too much. It can and will break if
you flood the communication channel with the terminal.
Contributing and Support
------------------------
Use https://git.janouch.name/p/neetdraw to report any bugs, request features,
or submit pull requests. `git send-email` is tolerated. If you want to discuss
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
License
-------
This software is released under the terms of the 0BSD license, the text of which
is included within the package along with the list of authors.
|
