No Description https://ascii.town
June c546925412
Fix Makefile indentation
3 weeks ago
.gitignore Ignore image 1 month ago
LICENSE Relicense AGPL 1 year ago
Makefile Fix Makefile indentation 3 weeks ago
README Only use pidfile(3) on FreeBSD 3 weeks ago
client.c Add -s flag to client 1 month ago
default8x16.psfu Add PNG renderer 1 month ago
help.h Use PascalCase for constants 1 month ago
image.c Refactor image.c 1 month ago
index.html Add ssh:// links to index.html 2 months ago
merge.c Use PascalCase for constants 1 month ago
meta.c Use PascalCase for constants 1 month ago
rc.torus Add rc.torus 3 weeks ago
server.c Only use pidfile(3) on FreeBSD 3 weeks ago
snapshot.sh Snapshot metadata 1 year ago
sshd_config Tabify source 4 months ago
torus.1 Only use pidfile(3) on FreeBSD 3 weeks ago
torus.h Use PascalCase for constants 1 month ago

README

torus(1)                FreeBSD General Commands Manual               torus(1)

NAME
server, client, image, meta, merge – collaborative ASCII art

SYNOPSIS
server [-d data] [-p pidfile] [-s sock]
client [-h] [-s sock]
image [-d data] [-f font] [-x x] [-y y]
meta
merge data1 data2 data3

DESCRIPTION
server maps a data file and listens on a UNIX-domain socket to
synchronize events between clients.

client connects to a UNIX-domain socket and presents a curses(3)
interface.

image renders a tile from a data file using a PSF2 font to PNG on
standard output.

meta extracts metadata from a data file on standard input to CSV on
standard ouput. The CSV fields are tileX, tileY, createTime,
modifyCount, modifyTime, accessCount, accessTime.

merge interactively merges two data files data1 and data2 into data3.
Differing tiles are presented in a curses(3) interface and are chosen by
typing a or b.

The arguments are as follows:

-d data
Set path to data file. The default path is torus.dat.

-f font
Set path to PSF2 font. The default path is default8x16.psfu.

-h Write help page data to standard output and exit.

-p pidfile
Daemonize and write PID to pidfile. Only available on FreeBSD.

-s sock
Set path to UNIX-domain socket. The default path is torus.sock.

-x x -y y
Set tile coordinates to render. The default coordinates are
32,32.

IMPLEMENTATION NOTES
This software targets FreeBSD and Darwin.

help.h contains tile data for the help page and can be generated from the
first tile of torus.dat.

default8x16.psfu is taken from kbd: http://kbd-project.org.

Causal Agency October 12, 2018 Causal Agency