Name Last Update
.github Loading commit data...
.vscode Loading commit data...
arch Loading commit data...
branding Loading commit data...
debian Loading commit data...
doc Loading commit data...
flathub Loading commit data...
flatpak Loading commit data...
icons Loading commit data...
locale Loading commit data...
mac Loading commit data...
rpm Loading commit data...
schemas Loading commit data...
src Loading commit data...
ui Loading commit data...
win Loading commit data...
.gitignore Loading commit data...
.gitmodules Loading commit data...
AUTHORS Loading commit data...
CHANGELOG Loading commit data...
LICENCA Loading commit data...
LICENSE Loading commit data...
Makefile.in Loading commit data...
PKGBUILD.mingw Loading commit data...
README.md Loading commit data...
autogen.sh Loading commit data...
configure.ac Loading commit data...
memchk.sh Loading commit data...
msys-run.sh Loading commit data...
pw3270.cbp Loading commit data...
valgrind.suppression Loading commit data...
validate-metainfo.sh Loading commit data...
wine-run.sh Loading commit data...

README.md

GTK Based 3270 terminal emulator

pw3270 is a modern, GTK-based, completely free tn3270 emulator.

Created originally for Banco do Brasil, it's now an official Brazilian Government Public Software project, and is used worldwide.

<!-- <a href="https://github.com/igrigorik/ga-beacon">https://github.com/igrigorik/ga-beacon</a> -->

License: GPL v3 CodeQL build result

Installation

You can download installation package for supported linux distributions in Open Build Service, the flatpak version from flathub and windows installer from Releases.

Alternative windows installers for stable and unstable versions are already available on Dropbox and one drive.

Building for Linux

```shell
$ git clone https://github.com/PerryWerneck/pw3270.git
$ cd pw3270
$ ./autogen.sh
$ make all
$ sudo make install
```

Building for Windows

Cross-compiling on SuSE Linux (Native or WSL)

  1. Add the MinGW Repositories

    $ sudo zypper ar obs://windows:mingw:win32 mingw32
    $ sudo zypper ar obs://windows:mingw:win64 mingw64
    $ sudo zypper ar obs://home:PerryWerneck:pw3270 pw3270
    $ sudo zypper ref
    
  2. Run the build script

    $ wget https://github.com/PerryWerneck/pw3270/blob/master/win/pack.sh
    $ ./pack.sh --pre-reqs
    

Windows native with MSYS2

  1. Build and install libv3270

  2. Install required packages

    $ pacman -S mingw-w64-x86_64-imagemagick mingw-w64-x86_64-optipng mingw-w64-x86_64-inkscape
    
  3. Get pw3270 sources from git

    $ git clone https://github.com/PerryWerneck/pw3270.git ./pw3270
    
  4. Build library using the mingw shell

    $ cd pw3270
    $ ./autogen.sh
    $ make all
    

Building for macOS

Using homebrew

  1. Build and install libv3270

  2. Install additional dependencies

    $ brew install adwaita-icon-theme imagemagick
    
  3. Configure and build

    $ ./autogen.sh
    $ make all
    
  4. Create app bundle

    $ cd macos
    $ ./bundle
    

Using jhbuild

  1. Install jhbuild and GTK-OSX

    https://wiki.gnome.org/Projects/GTK/OSX/Building

  2. build

    jhbuild --moduleset=https://raw.githubusercontent.com/PerryWerneck/pw3270/master/mac/pw3270.modules build pw3270