Skip to main content

gdicons

A Python library to render Geometry Dash icons.

Usage

Import the library like so:

from gdicons import *

Prerequisites

This library requires a Geometry Dash Steam installation, or at the very least, a Resources folder containing the following:

  • An icons folder containing each icon in all three qualities
  • Robot_Animdesc.plist
  • Spider_Animdesc.plist

By default, it will set its resources path to the one included in a default Steam installation. To override this, call this function:

set_resources_path(<path to Resources folder>)

Render an Icon

To render an icon, call this function:

rendered_icon = render_icon(...)

This returns a PIL Image object, which can then be saved to a file.

Parameters

Parameter name Parameter description
gamemode The gamemode to render. Can be one of "cube", "ship", "ball", "ufo", "wave", "robot", "spider", "swing", or "jetpack".
id The ID of the gamemode to render.
primary The primary color of the rendered icon. Can be a hexadecimal string ("#0b172b"), color string ("red"), or Geometry Dash color ID. See GDBrowser's iconkit for a list of Geometry Dash color IDs.
secondary The secondary color of the rendered icon.
glow The glow color of the rendered icon. Can also be False to disable glow, this is default.
quality The texture quality of the rendered icon. A higher quality leads to a higher size. Can be one of "low"/"normal", "hd", or "uhd". Default "uhd".

Usage Example

from gdicons import *

viprin_cube = render_icon(
    gamemode  = "cube",
    id        = 133,
    primary   = "#ffff00",
    secondary = "#b900ff",
    glow      = "#b900ff"
)
nexus_spider = render_icon(
    gamemode  = "spider",
    id        = 13,
    primary   = 9,
    secondary = 12,
    glow      = 12
)

viprin_cube.save("viprin.png")
nexus_spider.save("nexus.png")

Output

A rendered image of Viprin's cube A rendered image of Nexus' spider

Metadata

Release files for gdicons 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gdicons 1.2.0
File Size Uploaded Provenance
gdicons-1.2.0.tar.gz 44.3 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for gdicons 1.2.0
File Interpreter ABI Platform
gdicons-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 76.2 kB

Release files / gdicons-1.2.0.tar.gz

Download URL gdicons-1.2.0.tar.gz
Size 44.3 kB
Tags Source
SHA-256 checksum
How to use checksums
bdec783134936eb1bd22bf601b81f04b5a2e5f6ea762fc51346bd3338c1448d0
BLAKE2b-256 checksum
How to use checksums
3534fce434e6d5277160264bb3c1a98df99e696322c8de898c863c4365574323
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.0 CPython/3.12.1

Release files / gdicons-1.2.0-py3-none-any.whl

Download URL gdicons-1.2.0-py3-none-any.whl
Size 31.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
cdd898c6c107e0b8e9f59696cdef30b8aa555874b9d274cd63f962296cd36bde
BLAKE2b-256 checksum
How to use checksums
7d26a25af9428e5963d96fcc4c6bb2c5ab8e7b6e61bcc21bc469757ad6acdfd4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.0 CPython/3.12.1

Security for gdicons 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page