Skip to main content

pyproject-appimage

PyPI - License PyPI - Python Version PyPI - Downloads

pyproject-appimage allows you to create a AppImage in a few seconds. To get started, just add this to your pyproject.toml:

[tool.pyproject-appimage]
script = "my-app"
output = "MyApp.AppImage"

script is here the script that should be run when executing the AppImage. You can use the project.scripts section of your pyproject.toml or the entry_points argument of your setup.py to create scripts.

To create a AppImage, just run this command in your project directory:

pyproject-appimage

Pyproject options

The following options can be used in your pyproject.toml:

Option Type Description
script string The script that should be run
output string The filename of your AppImage. Can be overwritten with the cli.
icon string The path to your Icon
rename-icon string Give your Icon another name inside the AppImage
desktop-entry string The path to your .desktop file
rename-desktop-entry string Give your .desktop file another name inside the AppImage
gettext-desktop-entry bool If your .desktop file should be translated using gettest
appstream string The path to your AppStream file
rename-appstream string Give your AppStream file another name inside the AppImage
gettext-appstream bool If your AppStream file should be translated using gettest
gettext-directory string The path to your gettext directory
python-version string The Python version that is used. Default is your current version. Can be overwritten with the cli.
updateinformation string The update information
compression string The Squashfs compression
additional-packages list of strins A list of packages that should also be installed

Note: All paths are relativ to your project directory

Cli options

pyproject-appimage provides the following cli options:

usage: pyproject-appimage [-h] [--output OUTPUT] [--project-dir PROJECT_DIR] [--python-version PYTHON_VERSION] [--appimagekit-url APPIMAGEKIT_URL] [--work-dir WORK_DIR]
                          [--list-available-versions] [--no-fuse] [-v]

options:
  -h, --help            show this help message and exit
  --output OUTPUT       Sets the putput filename
  --project-dir PROJECT_DIR
                        Sets the project dir
  --python-version PYTHON_VERSION
                        Set a custom Python version
  --appimagekit-url APPIMAGEKIT_URL
                        Set a custom download URL for AppImageKit
  --work-dir WORK_DIR   Set a custom directory to work in. Existing Directories will be removed.
  --list-available-versions
                        Print available Python versions and exit
  --no-fuse             Use this, if FUSE is not available e.g. inside a Docker container
  -v, --version         Prints the version and exit

Projects using pyproject-appimage

pyproject-appimage is of course also available as AppImage

pyproject-appimage is based on the work of niess

Release files for pyproject-appimage 4.3

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

Source distribution (sdist)

Source distribution for pyproject-appimage 4.3
File Size Uploaded
pyproject_appimage-4.3.tar.gz 39.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for pyproject-appimage 4.3
File Interpreter ABI Platform
pyproject_appimage-4.3-py3-none-any.whl Python 3 none any Details

Total release size: 77.4 kB

Release files / pyproject_appimage-4.3.tar.gz

Download URL pyproject_appimage-4.3.tar.gz
Size 39.7 kB
Tags Source
SHA-256 checksum
How to use checksums
03a6afd07672f406f9df18ae3f424f6a370139bbe8f463f729a76fad4a42da3a
BLAKE2b-256 checksum
How to use checksums
c58253173c26fd898cb3b4e0c1cd04b2f385aec5738c467074caa1b4e6018b62
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release files / pyproject_appimage-4.3-py3-none-any.whl

Download URL pyproject_appimage-4.3-py3-none-any.whl
Size 37.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b9fdc6d1829ead1ca3021fe6d8c9e7c2830b43426c427d91b3d07c5480fd07b6
BLAKE2b-256 checksum
How to use checksums
2329991440c645bd0536fa67f8d8e584ce9db4b106451f088b7074047cf7a3d7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.5

Release history Release notifications | RSS feed

This release

4.3 This release

2 release files

4.2

2 release files

4.1

2 release files

4.0

2 release files

3.1

2 release files

3.0

2 release files

2.0

2 release files

1.0

2 release files

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