This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

Naghni is a simple side-scrolling game. You are a round creature whose purpose is to fill empty holes with matter, thus closing them. It matters greatly to your round friends that you do a job well-done, because if you don’t, they’re all going to die!

If you want to save the naghnies (for that is the name of the people), you should not hesitate to play Naghni. You will be their Saviour, their Hope, their Light in the darkest of times.

Naghni levels consist of you and a lot of other objects. At least one hole is always present. It is your purpose to collect edible objects and then return those objects to the holes. Holes disappear when they have had enough to eat. When all holes are gone, the level has been completed. Holes differ from other objects in that they have borders.

As of now, it’s not possible to die. You may however end up in situations that require a restart.

Naghni is free software under the terms of the GNU General Public License version 3 (or any later version). The author of Naghni is Niels Serup, contactable at . This is version 0.1 of the program. Naghni includes program data created by other people and under other free licenses; the details can be found in the file LICENSING.txt.


Naghni depends on PyGame 1.8.1+ for graphics and sound. To install PyGame, do one of these things:

Naghni also depends on pycairo, NumPy and librsvg.

apt-get install python-cairo, or yum install pycairo, or visit

apt-get install python-numpy, or yum install python-numpy, or visit

apt-get install python-rsvg, or gnome-python2-rsvg, or

Optional extras

If present, Naghni will also use these Python modules:

Web address:
$ sudo easy_install setproctitle
Web address:
$ sudo easy_install termcolor

Way #1

Get newest version of Naghni at

Extract the downloaded file and run this in a terminal:

$ sudo python install

Way #2

Just run this (requires that you have python-setuptools installed):

$ sudo easy_install naghni


When Naghni has been installed, you can run it from the command-line like this:

$ naghni [options]

naghni has several options. Run naghni --help to see a list of them. Most of them can also be changed in-game.


All special aspects of Naghni will (ultimately) be explained in-game. Do not worry. Use the arrow keys to control your character, press PageUp/PageDown to zoom in/out and Shift+F to toggle an FPS viewer. Press the R key to restart a level.

For developers

Naghni uses Git for branches. To get the latest branch, get it from like this:

$ git clone git://

Naghni is written in Python and should be relatively easy to integrate into other programs (in the future, that is).

Designing levels

Levels are simply Python files using the Naghni Python files installed as a mini library. The easy way to create a new level is to modify an existing level. Such levels can be found in the naghnilevels directory within the data directory. No real documentation is present at this time, and the “API” might change in the future.

The future / TODOs

Naghni currently misses several features.

  • It doesn’t have a menu.
  • It only works with SDL. Creating bindings to OpenGL might be a good idea.
  • It has only 3 builtin levels, and all of them are test levels, i.e. they are not hilariously fun to play.
  • There is no story mode. There is barely any story, anyway.
  • Characters are boring circles. They should have fancy things on them (like eyes, ears, tentacles, etc.).
  • It has only 3 builtin patterns. More are needed.
  • It lacks real background color/image support.
  • It lacks documentation (and a finalized level “format”).
  • It lacks music and sounds.
  • It hasn’t been tested thorougly.
  • Too few people are playing it.
  • There are a few physics-related issues which need to be fixed. It would be nice to implement Naghni in a general-purpose physics engine instead of its current fault prone one.
  • It’s slow. Optimization is sadly a must. The more objects a level has, the slower it is, partly because of slow loops.
  • Code (especially the more complex stuff) isn’t explained very well.
  • Probably several other things as well.

It will take time to fix this.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Naghni-0.1.tar.gz (322.1 kB) Copy SHA256 Checksum SHA256 Source Aug 21, 2010

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting