Launching Sigilis with sigilis:// URIs

Prime Sigilis Dec 19, 2008

On the website you will encounter URIs that look like this: sigilis://pos/1/23/345

There are three types of sigilis URIs:

Position: sigilis://pos/1/0/0 Each sector in Sigilis (currently only Sector 1 active) is 1,024,000 x 1,024,000 units. The X and Y values run from -512,000 to 512,000 with 0,0 at the exact center of the sector. When looking at a map negative X values are to the left of center and positive X to the right. Negative Y values are below center and positive Y above. A valid Position URI consits of: sigilis://pos/sector_number/X_value/Y_value

Grid: sigilis://grid/1/511/511 Each sector in Sigilis (currently only Sector 1 active) is 1,024 x 1,024 grid units. When looking at a map of a sector, the grid numbers run from 0,0 in the top left corner to 1023,1023 in the bottom right corner, with the first number representing left to right and the second top to bottom. A valid Grid URI consists of sigilis://grid/sector_number/grid_number_1/grid_number_2

Star: sigilis://star/1/Rs/23/Gr/52 Each sector in Sigilis has its own orientation in relationship to the 3 Stars of Sigilis. When looking at a map of sector 1, the left half of the map is Red Set and the right is Red Rise (which are the direction the the Red Star rises and sets). Values run from 0 in the middle to 512,000 at the side edges. The top half is Green Rise and the bottom is Green Set. Values run from 0 in the middle to 512,000 at the top and bottom edges. For sector 1 the 4 direction markers are then: Rr for Red Rise, Rs for Red Set, Gr for Green Rise, and Gs for Green Set. A valid Star URI consists of sigilis://grid/sector_number/direction_marker_1/distance_1/direction_marrker_2/distance_2

Once your Sigilis program has upgraded its script to a version above 0.2 (this will happen automatically when you start the program if you are running an earlier version), then you will have the ability to start the program like this:

python sigilis://pos/1/0/0

where  sigilis://pos/1/0/0 can be replaced by any valid sigilis URI. It is possible to not bother with making a shell script or batch file in the following directions and just make the protocol association point to the main Sigilis script. The reason a batch file would be helpful is it can be later modified to handle a situation where the Sigilis program is already running. First this functionality will need to be added to the program. Currently, following these directions will mean that a new copy of the program will start if you follow a URI while the program is still running.  

Create Batch File or Shell Script 


Create a shell script that changes directory to where your Sigilis scripts are and the executes thescript in a terminal. Here it is using gnome-terminal, but this could be xterm or some other terminal program:

cd /path/to/sigilis/CLIENT/v_.2/
gnome-terminal -e "python $1"

After saving the script type with a name like 'sigilis-start':

chmod +x sigilis-start

Now the script will be runnable from the command line.



Similar to unix/linux, create batch file like this:

cd C:\Program Files\Sigilis_v_.1\ 
term -e "python $1" 


For a Mac the method would be the same as unix/linux except the first line would be #!/bin/bash instead of #!/bin/sh and you would need to change the terminal program referenced, so I believe it would look like:

cd /path/to/sigilis/CLIENT/v_.2/
Terminal -e "python $1" 


Associate Protocol In Browser and/or OS 

You can associate a protocol with your browser or it can be associated for all programs that would understand a URI throughout your operating system. If you make the association through your OS then it will be more effective.


In Gnome-based desktop system you just have to add a folder named 'sigilis' to ~/.gconf/desktop/gnome/url_handlers and then create a file name %gconf.xml in that folder with the following content:

<?xml version="1.0"?>
<entry name="needs_terminal" mtime="1229678965" type="bool" value="false">
<entry name="enabled" mtime="1229678865" type="bool" value="true">
<entry name="command" mtime="1229677901" type="string">
<stringvalue>sigilis-start %s</stringvalue>

Just replace sigilis-start with the name of your script.


Go to Control Panel->Programs->Default Programs->Set your default programs and the associate sigilis with the batch file you created.


Coming soon...


Firefox (and other mozilla-based browsers): 

  • In the navigation bar type: about:config and hit enter.
  • After agreeing that you understand you could cause problems, you will see a list of settings.
  • Right click anywhere on the window and choose New--> String
  • Enter for the string and the name of the batch file you created (/bin/sigilis-start) for the value.


  • Hit Ctrl-F12 or choose Tools-->Preferences
  • Open the Advanced Tab and choose Programs on the left, then click on Add... on the right.
  • For Protocol type: sigilis
  • Choose 'Open with other application' under Action and type the path to the script you created above. In unix style systems it would be something like /bin/sigilis , and in windows something like: C:\Program Files\Sigilis\startup.bat

To add comments to an article, you must be logged in.