Getting started

Installation

Pre-packaged

UNDER CONSTRUCTION, NO PACKAGE HAS BEEN RELEASED YET

Outspline has packages available for the following Linux distributions:

• Arch Linux: simply install the outspline package from the AUR; additionally, the outspline-extra, outspline-experimental and outspline-development packages are available.

Manual

TODO

This installation procedure is mostly useful to create packages for operating systems that do not provide a pre-packaged version yet.

Dependencies:

• Python 2.7 or greater (not 3!)
• wxPython 3.0.0.0 or greater

$ curl -LO http://downloads.sourceforge.net/project/kynikos/arch/outspline-0.8.0.tar.bz2
$ tar xjf outspline-0.8.0.tar.bz2
$ cd outspline-0.8.0
$ sudo python2 setup.py install --optimize=1

When installing additional components, some files may have to be deleted: TODO

$rm $pkgdir/usr/lib/python2.7/site-packages/outspline/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/extensions/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/plugins/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/components/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/info/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/info/extensions/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/info/plugins/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/conf/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/conf/extensions/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/conf/plugins/__init__.py{,c,o}
$ rm $pkgdir/usr/lib/python2.7/site-packages/outspline/dbdeps/__init__.py{,c,o}

After installation, the icon cache may have to be refreshed:

$ sudo gtk-update-icon-cache -q -t -f usr/share/icons/hicolor

Usage

After the installation, an icon should have been added to the applications menu. Alternatively, Outspline can be launched from the command line with the outspline command. See Usage for more information.

Run without installing

TODO

This procedure is mostly useful for testing or development.

Dependencies:

• git
• Python 2.7 or greater (not 3!)
• wxPython 3.0.0.0 or greater

$ mkdir outspline-test
$ cd outspline-test
$ git clone https://github.com/kynikos/outspline.git
$ git clone https://github.com/kynikos/lib.py.configfile.git
$ git clone https://github.com/kynikos/lib.py.plural.git
$ git clone https://github.com/kynikos/lib.py.text-history.git
$ git clone https://github.com/kynikos/lib.py.wxclasses.git
$ PYTHONPATH="$PYTHONPATH:$PWD/src:" python2 ./src/scripts/outspline [OPTIONS]