celestine 2025.2.17

A python framework for desktop applications.

A python framework for desktop applications. Featuring support for multiple graphical user interfaces. Localized for members of the European Union.

About

The only requirement is Python. However, you can install additional packages for extended functionality.

This has also been designed to run as a Blender Add-on! Note that Blender is an isolated environment, so other packages can not be used with it.

Project Update

In this release, curses is back online. Tkinter, Curses, and Pygame should all have a functioning image viewer. For the best results, use Pygame. [MacOS is having trouble with tkinter and Windows wont run curses natively.]

On Windows, it is recommended to install the Pillow package for the best results.

On MacOS, it is recommended to NOT install the Pillow package because of an unknown issue with the wrapper class. Blender support is something I still care about, but it is going to take a lot of work to fix it. The only real issue is that I need to wait until Blender has Python 3.12 before I can work on it again.

I might drop support for DearPyGui because that is what the package author seems to be doing. Though I could replace it with their new package, pilotlight.

Commands

Command line arguments to use when launching the application.

Applications

Built in application to try out. [The Translator application is probably broken.]

Application	Command	Information
Clean	celestine -a clean	Runs several code formatting tools to get ready for publishing.
Demo	celestine -a demo	Test application for changing screens with buttons.
Translator	celestine -a translator	Translate the default language file into the 24 other languages.
Viewer	celestine -a viewer	Test application for viewing a limited number of images.

Caution: By default the viewer application will try to load every image it finds begining with the current working directory.

Graphical User Interfaces

[Blender is not working because the current version of Blender still runs on Python 3.11.] [DearPyGui is not working because I have not kept up its maintenance either.]

Interface	Source	Command
blender	Blender Foundation [1]	-i blender
curses	Python Standard Library [2]	-i curses
dearpygui	Python Package Index	-i dearpygui
pygame	Python Package Index	-i pygame
tkinter	Python Standard Library [3]	-i tkinter

Natural Languages

[These translations might only be partially working because I have not updated them in a while.]

Language	Translation [4]	Command
Bulgarian	български	-l bg
Czech	čeština	-l cs
Danish	dansk	-l da
German	Deutsch	-l de
Greek	ελληνικά	-l el
English	English	-l en
Spanish	español	-l es
Estonian	eesti	-l et
Finnish	suomi	-l fi
French	français	-l fr
Irish	Gaeilge	-l ga
Croatian	hrvatski	-l hr
Hungarian	magyar	-l hu
Italian	italiano	-l it
Lithuanian	lietuvių	-l lt
Latvian	latviešu	-l lv
Maltese	Malti	-l mt
Dutch	Nederlands	-l nl
Polish	polski	-l pl
Portuguese	português	-l pt
Romanian	română	-l ro
Slovak	slovenčina	-l sk
Slovenian	slovenščina	-l sl
Swedish	svenska	-l sv

Optional Dependencies

[Right now the Pillow package is almost required since I have not tested the non Pillow paths very much.]

Package	Description
dearpygui	DearPyGui: A simple Python GUI Toolkit
pygame	Python Game Development
windows-curses [5]	Support for the standard curses module on Windows
pillow	Python Imaging Library (Fork)

Project Links

• Documentation

• Email

• Libraries.io

• PyPI

• Source

• Tracker

• Discord

Disclosures

• This project is Free and Open Source software.

• This project used Microsoft Copilot to aid in its development.

• This project used Microsoft Azure Translator for its language translations.

• We do not solicit or accept any financial contributions.

• We do not use, support, or endorse any form of cryptocurrency.

• Any claims of fundraising activities (for this project) are fraudulent.

Licences

The licence for Cascadia Code is the SIL Open Font License.

The licence for celestine is the European Union Public Licence.

Footnotes

[1]

Blender interface can only be run when this is installed as a Blender addon.

[2]

Windows does not come with Curses.

[3]

Not always installed. Espically on Linix.

[4]

Language files were translated from English using the Microsoft Azure Translator.

[5]

Package only needed on Windows. Unix and Linix already have Curses.