Set-up Instructions

appJar was designed for use in schools - it therefore doesn't require any kind of special installation.
Instead, just DOWNLOAD the ZIP file, unzip, and go - just put the folder in the right place.

Pip Installation

However, if you can install python packages - we support that too!

pip3 install appjar - this will download & install appJar ready for python 3.
pip3 install appjar --upgrade - this will upgrade appJar to the latest version.

NB. If you're on linux/Mac you might need to use sudo: sudo pip3 install appjar

# import the appJar library
from appJar import gui

Single-user Set-up

If you can't/don't want to install using pip, simply:

# import the appJar library
from appJar import gui

(As long as it's in the same folder as your code, it'll work...)


If you're on Linux you might be able to make this even simpler.
You might have a site-packages folder, that is already in your path.
In this case, put the appJar folder in ~/.local/lib/python3.x/site-packages/ where 3.x is the version of python that you use.

Multi-user Set-up

If you're trying to install appJar in a school, everyone can download their own copy (see above), or:

# add the appJar folder to your PATH
import sys
# import the appJar library
from appJar import gui

Advanced Set-up

If you've got friendly technicians, you can even avoid having to always add appJar to your path...


Create an environment variable, which will mean E:\PYLIB is always in your path.

Advertisement why?

Linux (Raspberry Pi) /MacOS

If you're running python from a terminal:

    echo 'export PYTHONPATH="${PYTHONPATH}:~/Documents/PYLIB"' >> ~/.bashrc

IDLE on Linux (raspberry Pi)/MacOS

If you're running python in IDLE, you'll need to add appJar to your site-packages

    mkdir -p ~/Library/Python/3.4/lib/python/site-packages
    cd ~/Library/Python/3.4/lib/python/site-packages
    echo '~/Documents/PYLIB' > appJar.pth
    import sys


If you're using PyScripter then follow the installation instructions above.

If you're having problems appending to the path, you can try escaping the path:

Alternatively, you can use the PyScripter menus:

NB. You will have to do this every time you run PyScripter, so it's better to get appJar installed properly if you can.


If you are using PortablePython then you simply need to drop the appJar folder into the Lib folder of the PortablePython installation.