billiards man page

billiards, billiards-browser — a free cue sports simulator.


billiards [OPTION...]


Billiards is a free cue sports simulator. It aims for physical accuracy and simplicity and should hopefully be useful for practicing billiards on your own and against your friends when a real pool table is not available. Currently both a pool table and a billiards table (that is with and without pockets) are implemented allowing you to play eightball, nineball and carom billiards games.


Billiards is an application for Techne.  All options described in techne(1) therefore apply here as well.   Billiards understands the following options:

eightball, nineball, carom

Start an eightball, nineball or carom game straight away without waiting for the web interface.  A useful shortcut if you're familiar with the command line.


Use the simpler cel shader.  This should run on all hardware.


If Billiards decides to use the toon shader by default, because it doesn't think much of your GPU, but you want to prove it wrong you can try this option.  You probably won't have much luck but it's worth a try.


If you need confirmation that your computer is indeed faster than your friend's specify this option to get a frame-rate counter.


Don't start the web server.


This annotates each ball with its current speed an spin when highlighted.  Mainly useful for debugging purposes.


If this option is used simulation goes into slow motion as soon as the cue ball is struck.  Can be useful when practicing, experimenting or debugging.


You can start Billiards from the command line for an eight-ball game without starting the web interface with the command

billiards -Oeightball

In order to start Billiards through the web interface and request a frame-rate counter and toon shading use this command

billiards-browser -Oframerate -Otoon


The full documentation for Billiards is maintained as a Texinfo manual.  If the info program and Billiards are properly installed at your site, the command

info billiards

should give you access to the complete manual.


Please report any bugs you find on the billiards-devel mailing list or use the bug tracker in Billiards' project page <>.


Dimitris Papavasiliou <dpapavas at gmail dot com>

See Also

techne(1), aviation(6), airrace(6)

Referenced By


November 2010 Linux