Skip to main content

A simple image viewer.

Project description

Documentation Status


View, tag, and organize your photos. Work in progress. Not currently functional.

By default this is a command line application. Should work anywhere Python 3 code can be run. The code has several folders dedicated to specific pluggins. If package not found, code not run. Can actually be deleted if desired.

Older description: Decided that the main reason behind this was an attempt to use HTML as my GUI. Most files in this project are dedicated to viewing and modifying local images. Will try to update the project to reflect that.

Primary Goals

  • Is an offline only application. (The only internet used is when you use pip.)

  • Has no required dependencies. (All you need to run this package is Python.)

  • Can be customized to use different packages. (See the list below for supported packages.)

Offline Only

The only internet you need is when you install with pip.

No Dependencies

Just download and run.

Custom Install

Choose which packages to use.

Swap packages

  • Has no required dependencies. (All you need to run this package is Python.)

  • Can be customized to use different packages. (See the list below for supported packages.)

Secondary goals: - Advanced tag searching. (Most websites have really lousy topic filters.)

What this is not: - This is not a photo editor. - This is not a photo downloader. - This is not a mobile application.




Optional Features




This project is written in Python.



tcl/tk and IDLE

Use this if you don’t trust DearPyGui.



Python test suite

Use this to run the tests yourself.





Celestine Image Viewer


This is the project you are trying to install.



pip install dearpygui

Without this, you need tkinter or the command line.



pip install Pillow

Without this most images wont load.

(Old notes. Still useful. Need to add to table above somehow.)

Recomended Python >= 3.9 (PEP 584) Pillow >= 7.2.0 (TIFF BYTE tags format)

Recommended Packages: Tkinter: Included in most python distributions, which means no installation or setup required. Adds GUI to application. Makes it easier for the average user to use. (Plus now you can actually see the images.)

Pillow: InstaLibrary for loading images. Allows for many image file types.

Optional Packages: Additional GUI libraries and features may be added in the future. Some configuration may be needed to toggle these additional features.

Rexex parser: Adds support for wildcard searches using ‘*’.

command core only the basics here use on web server or as external library


Safebooru - And the thousands of other booru sites.

Board Game Geek - Epic advancned search.


Semantic Versioning 2.0.0 Write to me

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

celestine-0.1.0.tar.gz (65.6 kB view hashes)

Uploaded source

Built Distribution

celestine-0.1.0-py3-none-any.whl (74.8 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page