Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/cosmos72/twin

Text mode window environment. A "retro" program for embedded or remote systems, that doubles as X11 terminal and text-mode equivalent of VNC server
https://github.com/cosmos72/twin

Last synced: 8 days ago
JSON representation

Text mode window environment. A "retro" program for embedded or remote systems, that doubles as X11 terminal and text-mode equivalent of VNC server

Host: GitHub
URL: https://github.com/cosmos72/twin
Owner: cosmos72
License: other
Created: 2014-11-08T17:43:52.000Z (about 10 years ago)
Default Branch: master
Last Pushed: 2023-10-29T19:35:21.000Z (about 1 year ago)
Last Synced: 2024-10-12T15:03:38.904Z (2 months ago)
Language: C
Homepage:
Size: 8.16 MB
Stars: 654
Watchers: 35
Forks: 38
Open Issues: 43
Metadata Files:
- Readme: README
- Changelog: Changelog.txt
- License: COPYING

Awesome Lists containing this project

fucking-Awesome-Linux-Software - ![Open-Source Software - Fast, lightweight text-mode window environment with mouse support. Enables multiple terminals in a single Linux console, terminal or X11 window. It can be detached (keeps running in background) and reattached to a different console, terminal or X11 server. Works on Linux, Mac OS X and BSD. (Applications / Terminal)
Awesome-Linux-Software - ![Open-Source Software - Fast, lightweight text-mode window environment with mouse support. Enables multiple terminals in a single Linux console, terminal or X11 window. It can be detached (keeps running in background) and reattached to a different console, terminal or X11 server. Works on Linux, Mac OS X and BSD. (Applications / Terminal)
awesome-starred - cosmos72/twin - Text mode window environment. A "retro" program for embedded or remote systems, that doubles as X11 terminal and text-mode equivalent of VNC server (others)

README

--------------------------------------------------------------
Twin - a Textmode WINdow environment
--------------------------------------------------------------

Version 0.9.0

Twin is text-based windowing environment with mouse support, window manager,
terminal emulator, networked clients and the ability to attach/detach
mode displays on-the-fly.

It supports a variety of displays:
* plain text terminals: Linux console, twin's own terminal emulator,
and any termcap/ncurses compatible terminal;
* 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.

The following screenshot shows an example of twin with various clients:
![screenshot_x11.png](docs/screenshot_x11.png)

Documentation
--------------------------------------------------------------

[Tutorial](docs/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](COPYING)
License: twin server and clients are GPL'ed software.

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

[INSTALL](INSTALL)
Quick compile/install guide.

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

The following documentation is useful mostly to developers:

[Configure](docs/Configure)
Description of twin configuration options with the meaning
of every single one.

[README.git](README.git)
Hints to build twin from GIT repository.

[README.porting](README.porting)
Tips and warnings to compile twin on unsupported OSes.

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

[libtw++.txt](docs/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](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](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](docs/Tutorial)

Greetings,

Massimiliano Ghilardi