Atropine starts a web server on your computer, and you administer the tournament from your browser. It doesn't need internet access to work, unless you use the exaggeratedly-named live broadcast feature.
Atropine has been tested on Windows and Linux, and waved in the general vicinity of a Mac.
Prerequisite: Python 3
To run Atropine, you need to have Python 3 installed. At the time of writing (June 2023), the latest release of Python 3 is version 3.11.4, but if there's a later version on the Python downloads page by the time you read this, then install that.
Python 2 is not supported, either by Atropine or by much else any more.
Download latest release: Atropine 1.2.2
This is the latest release of Atropine.
Download links for earlier Atropine versions can be found below.
Instructions for getting started
- If Python 3 is not already installed on your computer, or if you're not sure whether it's installed, download and install Python 3.
- Download the latest Atropine zip file from the download link above.
- Extract all the zip file's contents into a new folder of your choice. This
is where Atropine will be installed.
- This is an important step. You cannot simply run Atropine from inside the zip file! You must extract (or "unzip") its contents. On Windows 10, you want the "Extract all" button. Forgetting this step is the most common cause of Atropine "just not working".
- Don't move any of Atropine's files out of that folder - the location of atropine.py in relation to the subfolders must be maintained as it is. If you want to, it's okay to make a shortcut (or symlink, on Linux) to atropine.py and put the shortcut anywhere you want.
- Open the folder you extracted Atropine to, and run atropine.py.
- If you didn't fully extract the zip file, or you didn't install Python 3, this will become apparent now. Otherwise, if all went well...
- Atropine will open a small web server on your computer, and give you a link to paste into your browser, like this: http://localhost:3960/cgi-bin/home.py
- Go to that link in your web browser. You are now using the web interface, and you can create and administer your tournament from there.
The file webroot/docs/index.html in the zip file contains further information about using Atropine. You can also reach this from within Atropine using the Help link in the sidebar.
Atropine is available on GitHub.
Normally, you want the latest release in the table above. If for any reason you can't use the latest release, earlier releases are shown below.
|1.2.0||2022-08-12||atropine-1.2.0.zip||First new release in nearly two and a half years. New fonts. New standings table ranking methods. Better diagnostics for startup failure. Faster and improved Swiss fixture generator. Publicly displayed standings table now scrolls its pages faster by popular demand.|
|1.1.4||2020-03-07||atropine-1.1.4.zip||Improve fixture generator menu, and add fixture generator for a final.|
|1.1.3||2020-01-11||atropine-1.1.3.zip||Remove calls to a deprecated library function which is no longer present as of Python 3.8.|
|1.1.2||2019-11-09||atropine-1.1.2.zip||Fix bug introduced in 1.0.5 which stopped you from generating Swiss fixtures for a round which already has fixtures in another division.|
|1.1.1||2019-10-31||atropine-1.1.1.zip||Optimisation for upload feature: only upload tournament state if it's changed since the last upload.|
|1.1.0||2019-10-24||atropine-1.1.0.zip||Auto-upload live tourney updates to webpage (account required), standings table now takes account of any finals, lots of other little improvements.|
|1.0.5||2019-05-06||atropine-1.0.5.zip||Players can prefer specific table numbers, as well as requiring accessible tables; quite a few cosmetic "improvements".|
|1.0.4||2019-01-06||atropine-1.0.4.zip||Table numbers can be designated "accessible" for players who need them; improved player configuration page and display setup page; game results exportable to CSV.|
|1.0.3||2018-11-18||atropine-1.0.3.zip||Random fixture generator can now avoid rematches; option not to auto-switch to Fixtures display until all divisions have games generated; various appearance tweaks.|
|1.0.2||2018-08-17||atropine-1.0.2.zip||Improve Fully Manual generator, add more options to Standings/Table Results screen|
|1.0.1||2018-07-23||atropine-1.0.1.zip||Added Random from Seeded Pots fixture generator.|
|1.0.0||2018-07-23||atropine-1.0.0.zip||Ported to Python 3.|
pygame is no longer required
Versions of Atropine prior to 0.9.0 also required the Python "pygame" module for the full-screen public-facing display. Versions 0.9, 1.0.0 and onwards do not need this module any more. pygame's presence won't do any harm, so you don't need to remove pygame from your computer if you already have it installed, but it is no longer used by Atropine.
The reason we don't need pygame any more is because the public-facing display is now a web page, accessed through the Atropine web interface like everything else. The old standalone program "teleost" no longer exists. Instead, in the Atropine web interface, click "Display Setup" on the sidebar and then click the "Open Display Window" link at the top.
Legacy releases (for Python 2)
These older releases used Python 2. They are shown here for historical interest.
Please note that these releases are now many years old. There will be no more releases of Atropine for Python 2.