###############################################################################
#                           Atari Pythonizer                                  #
#              add random keyboard sounds to Rational Sounds                  #
#                                                                             #
#            based on the 'naughty bits' part of the 'Pythonizer'             #
#               that was included with the Monty Python cd-rom                #
#                     'A Complete Waste Of Time' (1996)                       #
###############################################################################


Intro
-----
If you remember Windows 95/98, you may also recall the Monty Python cd-rom 'A 
Complete Waste of Time'. It included a couple of long forgotten games and the 
Pythonizer.

The Pythonizer would add sounds to your keyboard. The sounds that impressed
me most were the 'naughty bits', a collection of farts and belches produced
by (I believe) Eric Idle. You could set the program to produce a sound at each 
keystroke or set it to random. That way it would produce a random sound at a 
random keypress.

Finally there is an equivalent for Atari ST systems with multitasking 
capabilities. You will need the excellent Rational Sounds (RASN) and Gemjing 
programs to get it working.
(https://www.st-computer.org/download/rasn.2.0.2.zip)

I took the original 'naughty' Python sounds from the cd and wrote a little 
program that will edit the Rational Sounds configuration file.


Install
-------
1. Put the included PYTHON sounds folder in the SAMPLES folder of your RASN 
install.

2. Edit PYTHONIZ.CFG.
 - You will need to check the path for the RASN.INF file (default C:\RASN) and 
   the path for the Python sounds (default C:\RASN\SAMPLES\PYTHON).
 - Set the 'incidence' as a value between 0 and 100. This is the percentage of 
   the available keys that will get a sound. Set this to 100 if you want a 
   sound assigned to all available keys.
 - In the list of available keys, uncomment (using "#") the keys you want to 
   exclude.


Running
-------
The program needs to run on shutdown. On a MagiC system you will need to put 
it in the C:\GEMSYS\MAGIC\STOP folder. The new settings will be available 
on the next reboot.
You can also run the program manually. After a manual start, you will need to 
make RASN reload the newly created configuration. The easiest way is to run 
RASNCONF.PRG, click the 'Tasten' tab and then click 'OK'. This will reload the 
new config file.


How it works
------------
The Atari Pythonizer will make a random selection of the available keys based 
on the incidence you have set. Then it will assign a random sound (from all 
sound files in the PYTHON folder) to each selected key. It will then rewrite 
RASN.INF.
Of course you don't have to use the Python sounds. You can set any folder and 
fill it with sound files you like. The only requirement is that the sound 
files are in 8 bit unsigned WAV format. I use Audacity (available for Windows 
and Linux) for the conversion.


Contact
-------
This version 0.2 of 08-01-2023  ACWOT Software

If you want to contact me, mail to rob@vousten.nl or send a PM to robv on 
atari-forum.com.
