===============================================================================
PsionLX SOFTWARE
Programs, games and fonts for PsionLX on the Psion Teklogix netBook Pro
===============================================================================
Everything the full PsionLX image (../PsionLX/1-IMAGES/psionlx-cf-1gb.img)
adds to Psion's own image, and a Spotify app, as packages for Psion's own
package manager, so a netBook Pro running ANY PsionLX card can install them:
Find new software Psion's own TASKS entry, finished: the catalogue that
installs everything below, and a helper that sets
Firefox up for PsionNet
Spotify your Spotify, played through PsionNet (Premium)
Games Bombs, Tetris, Othello, Go, Lights Out, Sokoban
Tools Jotter, Plucker, Watch, Time Tracker, Program manager
Sound Play and Record, Audio mixer
Internet Telnet, WLAN Config
Fonts Psion's Agfa fonts: Albany, Arial Narrow, Cumberland
and Thorndale
The full image has all of these already except Spotify, which is one
Install away. On every card, "Find new software" lives where Psion put it,
on the TASKS screen -- the task Psion listed in 2005 and never finished.
-------------------------------------------------------------------------------
WHAT YOU NEED
-------------------------------------------------------------------------------
* A netBook Pro running PsionLX from a CF card -- any of the three images
in ../PsionLX/1-IMAGES.
* A network connection for it: a wired or wireless network card.
* PsionNet, free, on a Mac on the same network:
https://github.com/JYewman/PsionNet
with Device set to "netBook Pro (PsionLX, network)" and the proxy
started. The netBook Pro cannot fetch from this archive itself -- its
secure-connection (TLS) support is twenty years out of date -- so PsionNet
fetches for it.
-------------------------------------------------------------------------------
INSTALLING
-------------------------------------------------------------------------------
1. On the Mac, start PsionNet with "netBook Pro (PsionLX, network)" and
press Start. Note the address it shows, for example 192.168.1.4.
2. On the netBook Pro, open Terminal (PROGRAMS > OTHER) and type, using
the Mac's address:
su
wget -O - http://192.168.1.4:8080/lx/install | sh
su asks for no password on PsionLX. The installer sets up Psion's
package manager to fetch from this folder through PsionNet, installs
"Find new software", and says "Done". The desktop blinks once as
Psion's launcher restarts with the TASKS entry working. Programs that
are on the card already -- from an earlier full image -- are put on
record, so they show as installed.
3. Tap TASKS, then Find new software. Pick something and press Install.
New programs appear in PROGRAMS straight away. (If you have given
PsionLX a root password, it asks for it.)
The installer is install.sh, in this folder. PsionNet puts its own address
into it as it hands it over. Run any other way -- copied across on a card,
say -- it needs the address given:
sh install.sh 192.168.1.4:8080
-------------------------------------------------------------------------------
WHAT IT CHANGES ON THE MACHINE
-------------------------------------------------------------------------------
* Packages only add files; none replaces one of Psion's, and Remove (in
"Find new software") takes a package's files away again.
* The one exception is Psion's launcher, gpe-appmgr: its TASKS entry
"Find new software" has no command, so installing Find new software
swaps in a copy that runs it -- the same 34-byte change as in the full
image, made only over Psion's exact program. Psion's copy is kept in
/usr/lib/psionlx-software and put back if Find new software is removed.
* /etc/ipkg/psionlx-software.conf says where packages come from.
* At each login, psionnet-connect looks for PsionNet and writes
~/.psionnet/proxy.pac, which Firefox follows: the web goes through
PsionNet when it is there, and straight out when it is not. To manage
Firefox's proxy yourself instead, create the file ~/.psionnet/manual.
* Psion's Agfa fonts replace Psion's own, empty, agfa-fonts package, and add
a marked block to /etc/fonts/local.conf that keeps the desktop's lettering
in Bitstream Vera, as Psion had it. Removing them takes the block out.
* The internal flash (NAND) is never touched.
-------------------------------------------------------------------------------
WITHOUT PsionNet
-------------------------------------------------------------------------------
These are ordinary ipkg packages. Copy the ones you want onto an SD card or
a USB stick, put it in the netBook Pro, and in Terminal:
su
mount /media/mmc (a USB stick: /media/usb)
ipkg-cl install /media/mmc/gpe-tetris_0.6-2-r0_armv5te.ipk
Spotify and "Find new software" are no use without PsionNet; the games,
tools and fonts are.
-------------------------------------------------------------------------------
WHAT IS IN THIS FOLDER
-------------------------------------------------------------------------------
*.ipk the packages, in the format Psion's own build made them
Packages ipkg's list of them, with each one's size and MD5 checksum
catalogue.txt what "Find new software" shows: names, descriptions, icons
icons/ its icons
install.sh the installer described above
SHA256SUMS.txt checksums of every file here
Built by scripts/mkfeed.py in the PsionLX build system
(../PsionLX/4-BUILD-SYSTEM), from the same files the full image is built
from. Each package depends only on packages in Psion's own image, worked
out from the libraries its programs use. The source of "Find new software"
is at https://github.com/RetroTechCollection/PsionLX-Software, and of
Spotify in PsionNet.
Spotify is a trademark of Spotify AB; neither program is made or endorsed by
Spotify.
