You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Massimiliano Ghilardi 24a7b1550f server: fix typo 'screen' -> 'Screen' in rcparse.l 7 days ago
TODO Move configuration files to XDG-compliant paths: 2 months ago
admin Move configuration files to XDG-compliant paths: 2 months ago
clients client, server: change some variable names to lowercase 4 weeks ago
conf libs/libtstl: improve error messaged for dlopen() and dlsym() 2 weeks ago
contrib client, server: change some variable names to lowercase 4 weeks ago
docs server: cleanup obj/msg.h 3 weeks ago
fonts version 0.5.2 15 years ago
include fix a typo in include/m4/Tw_common.m4 1 week ago
libs libs/libtutf: add TW_CONST to exported global arrays 1 week ago
m4 fix #33: rename identifiers starting with _ 2 years ago
scripts Move configuration files to XDG-compliant paths: 2 months ago
server server: fix typo 'screen' -> 'Screen' in rcparse.l 7 days ago
test server: remove all remaining C++11 features, compile with -std=c++98 2 months ago
.clang-format server/tty.cpp: fix declaration of TtyWriteAscii and TtyWriteHWAttr 3 years ago
.gitignore server: remove special cases in msg serialization to be sent to clients 2 months ago
BUGS updated BUGS 6 years ago
COPYING version 0.2.6 20 years ago
COPYING.LIB delete discontinued library libTT and demo clients using it. 3 months ago
Changelog.txt rename libs/libTutf -> libs/libtutf 2 years ago
INSTALL remove 'gfx' and 'ggi' drivers 2 years ago
Makefile.am Move configuration files to XDG-compliant paths: 2 months ago
Makefile.in Move configuration files to XDG-compliant paths: 2 months ago
README recreated README and server/missing.c as symlinks 5 years ago
README.git * commented "GlobalFlags +TerminalsUtf8" in distributes system.twinrc 6 years ago
README.md Move configuration files to XDG-compliant paths: 2 months ago
README.porting version 0.8.0 5 years ago
acinclude.m4 improved compiling and loading modules with libtool; various autoconf-related fixes; added autogeneration of include/version.h 6 years ago
aclocal.m4 delete discontinued library libTT and demo clients using it. 3 months ago
configure regenerate ./configure script 2 months ago
configure.ac Move configuration files to XDG-compliant paths: 2 months ago
missing_checks libs/libTw: remove hand-optimized i386 assembly 3 years ago
twenvrc.sh Move configuration files to XDG-compliant paths: 2 months ago
twin-current.lsm update contact information 3 years ago
twinrc Move configuration files to XDG-compliant paths: 2 months ago

README.md

Twin - a Textmode WINdow environment, by Massimiliano Ghilardi

Version 0.8.1

Twin is a windowing environment with mouse support, window manager, terminal emulator and networked clients, all inside a text display.

It supports a variety of displays:

  • plain text terminals (any termcap/ncurses compatible terminal, Linux console, twin's own terminal emulator);
  • X11, where it can be used as a multi-window xterm;
  • itself (you can display a twin on another twin);
  • twdisplay, a general network-transparent display client, used to attach/detach more displays on-the-fly.

Currently, twin is tested on Linux (i386, x86_64, ARM, ARM64, PowerPC, Alpha, Sparc), on Mac OS X (x86_64) and on FreeBSD (i386, x86_64). I had yet no chance to seriously test it on other systems.


Documentation

Tutorial A quite complete tour of twin features: the user interface, how to use twin clients, compression, attaching/detaching displays, fonts. It also contains installation instructions and some caveats for system administrators.

COPYING License: twin server and clients are GPL'ed software.

COPYING.LIB Library license: the libraries libtutf, libtw are LGPL'ed software.

INSTALL Quick compile/install guide.

twinrc A detailed example of ~/.config/twin/twinrc look-n-feel configuration file.

The following documentation is useful mostly to developers:

Configure Description of twin configuration options with the meaning of every single one.

README.git Hints to build twin from GIT repository.

README.porting Tips and warnings to compile twin on unsupported OSes.

libtw.txt reference API for programmers who want to write twin clients (INCOMPLETE).

libtw++.txt reference API for programmers who want to write twin C++ clients (INCOMPLETE).


Getting twin

Since you are reading this README, you probably already have it, anyway twin can be downloaded from

https://github.com/cosmos72/twin


Building and installing twin

For detailed instructions about compiling and installing twin, see sections 3 and 4 of the file docs/Tutorial

For the impatient, it basically reduces to

  ./configure
  make

then run as root

  make install

on Linux, also remember to run as root:

  ldconfig

on FreeBSD instead, remember to run as root:

  ldconfig -R

To compile twin you need the following programs installed on your system:

  • a Bourne-shell or compatible (for example bash, dash, ash...)

  • make (most variants are supported: GNU make, BSD make...)

  • an ANSI C compiler (for example gcc or clang)

Note: it is STRONGLY recommended to install at least the following packages before compiling twin (the exact names depend on the operating system or Linux distribution):

  • x11-dev - may be named x11-devel, libx11-dev ...
  • xft-dev - may be named xft-devel, libxft-dev ...
  • ncurses-dev - may be named ncurses-devel, libncurses-dev ...
  • zlib-dev - may be named zlib1g-dev, zlib-devel, libzlib-dev ...

On Linux, it is STRONGLY recommended to also install the following package before compiling twin:

  • gpm-dev - may be named gpm-devel, libgpm-dev ...

For a discussion about MANUALLY configuring twin (almost never necessary), see the file docs/Configure. -- WARNING: if you manually enable options that were disabled by `./configure', build will almost certainly fail! --


Other topics:

See the rest of the documentation, starting from the Tutorial

Greetings,

Massimiliano Ghilardi