README.md 3.6 KB

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

Linux

You can download installation package for supported distributions in Open Build Service or the flatpak version from flathub.

Windows

Updated windows installers are available on Dropbox, google drive 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