FrontEngine

Support this project on Steam

About

FrontEngine is a lightweight and flexible framework designed to simplify automation and visualization tasks.
It provides an intuitive interface and supports multiple media formats for interactive demonstrations.

FrontEngine UI

Features

  • GIFs & Animations
    (GIFs may take time to load)
    GIF
    WEBP

  • Video
    Video

  • Website
    Website

  • YouTube Showcase
    Watch on YouTube

Desktop pet

Spawn an animated sprite that lives on your desktop, from the Pet tab.

  • Sprites — pick a single GIF/WebP/PNG, or a pet pack folder whose file names map to states: walk, idle, sleep, climb, fall, drag (missing states fall back to walk).
  • Behaviour — walk on the floor with gravity (throw it and it bounces), wander freely, or chase the cursor. Floor pets can climb screen edges and stand on the top edge of other windows.
  • Life — mood, fullness and an affection level that persist between runs; the pet grows as it levels up, chats in speech bubbles, naps while you are away, and warns you about a low battery.
  • Interaction — drag it around, right-click to clone/feed/set a reminder, and drop a file onto it: an image or pet pack becomes its new look, anything else is eaten as a snack.
  • React to audio — the pet pulses to your speakers' output level. It reads only the Windows output meter (WASAPI IAudioMeterInformation); no audio is captured or recorded. Peaks are smoothed with an RMS window and a fast-attack/slow-decay envelope so the pulse breathes instead of flickering. On multi-monitor setups each pet follows the audio endpoint that matches its own screen, falling back to the default output device.

Audio features are Windows-only and degrade to "no pulse" elsewhere.

Install

  • System Requirements

    • Python 3.10+
    • Windows 10/11 is the primary target; macOS and Linux are supported but may need extra OS dependencies.

  • From PyPI

    pip install frontengine

  • Pre-built binaries

Development

  • Requires Python 3.10+.
  • Install the dev toolchain: 
    pip install -r dev_requirements.txt
pip install -e .
  • Run the unit smoke tests: 
    python ./tests/unit_test/start/start_front_engine.py
python ./tests/unit_test/start/extend_front_engine.py
  • Contributions and pull requests are welcome!

Continuous Integration & Release

This repository ships two GitHub Actions workflows:

Workflow Trigger Purpose
CI (.github/workflows/ci.yml) Push / PR to main or dev, daily cron Matrix smoke test across Python 3.10 / 3.11 / 3.12 on Windows
Release (.github/workflows/release.yml) A pull request is merged into main (or manual dispatch) Auto-bumps the version in stable.toml/pyproject.toml, commits the bump back to main, swaps stable.toml → pyproject.toml, builds sdist + wheel, uploads to PyPI as frontengine via twine, creates a GitHub release tagged v<version>

Publishing only happens on merge to main — pushing to dev runs CI but never publishes. On merge, the workflow automatically bumps the patch segment of the version (configurable via manual dispatch: patch / minor / major), commits the bump back to main with [skip ci], then builds, uploads, and releases under the new version. Both the PyPI upload and the GitHub release see the bumped version, not the previous one.

Cutting a new release

  1. Merge a pull request into main — the patch version bumps automatically.
  2. That's it. PyPI publish and GitHub release happen in one workflow run.

For a minor or major bump, trigger the workflow manually via Actions → Release → Run workflow and pick the bump segment. That path also works when you need to re-run a failed publish without a new merge.

Required repository secrets

Secret Used by Contents
PYPI_API_TOKEN release.yml A PyPI API token scoped to the frontengine project

The workflow uses __token__ as the twine username, so only the token itself needs to be stored.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (1.0.77)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for JE-Chen from gravatar.com JE-Chen

Credits

PyPI data
Data sourced directly from PyPI's database.

Author: JE-Chen

Requires

Python >=3.10

Classifiers

Report project as malware

Download files

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

Source Distribution

frontengine-1.0.27.tar.gz (114.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

frontengine-1.0.27-py3-none-any.whl (160.1 kB view details)

Uploaded Python 3

File details

Details for the file frontengine-1.0.27.tar.gz.

File metadata

  • Download URL: frontengine-1.0.27.tar.gz
  • Upload date:
  • Size: 114.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for frontengine-1.0.27.tar.gz
Algorithm Hash digest
SHA256 c7c6a5f7eedb45a3730a89f3212493cd443f2934181bcb40ca3594bfb945c44c
MD5 679a82e9b6f5277ed6d0d2433645604e
BLAKE2b-256 0a44d6ba2e6142fc5ba2d716a54125c74001367337eafaf3b1a2f30862dba876

See more details on using hashes here.

File details

Details for the file frontengine-1.0.27-py3-none-any.whl.

File metadata

  • Download URL: frontengine-1.0.27-py3-none-any.whl
  • Upload date:
  • Size: 160.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for frontengine-1.0.27-py3-none-any.whl
Algorithm Hash digest
SHA256 43b7f5721b66bcd132be2360f07ceb13d3789c58c896c2a0b6021e6c57c1c377
MD5 68c4cc5bfd7f4aecd24546e45a10c897
BLAKE2b-256 68b7a42dacfb41efa14b124a92ce773decacf898a4fbae49f860ee9ccfaf1faa

See more details on using hashes here.

Release history Release notifications | RSS feed

1.0.77

1.0.76

1.0.75

1.0.74

1.0.73

1.0.72

1.0.71

1.0.70

1.0.69

1.0.68

1.0.67

1.0.66

1.0.65

1.0.64

1.0.63

1.0.62

1.0.61

1.0.60

1.0.59

1.0.58

1.0.57

1.0.56

1.0.55

1.0.54

1.0.53

1.0.52

1.0.51

1.0.50

1.0.49

1.0.48

1.0.47

1.0.46

1.0.45

1.0.44

1.0.43

1.0.42

1.0.41

1.0.40

1.0.39

1.0.38

1.0.37

1.0.36

1.0.35

1.0.34

1.0.33

1.0.32

1.0.31

1.0.30

1.0.29

1.0.28

This release

1.0.27

1.0.26

1.0.25

1.0.24

1.0.23

1.0.22

1.0.21

1.0.20

1.0.19

1.0.18

1.0.17

1.0.16

1.0.15

1.0.14

1.0.13

1.0.12

1.0.11

1.0.10

1.0.9

1.0.8

1.0.7

1.0.6

1.0.5

1.0.4

1.0.3

1.0.2

1.0.1

1.0.0

0.0.92

0.0.91

0.0.90

0.0.89

0.0.88

0.0.87

0.0.86

0.0.85

0.0.84

0.0.83

0.0.82

0.0.81

0.0.80

0.0.79

0.0.78

0.0.77

0.0.76

0.0.74

0.0.73

0.0.72

0.0.71

0.0.70

0.0.69

0.0.68

0.0.67

0.0.66

0.0.65

0.0.64

0.0.63

0.0.62

0.0.61

0.0.60

0.0.59

0.0.58

0.0.57

0.0.56

0.0.55

0.0.54

0.0.53

0.0.52

0.0.51

0.0.50

0.0.49

0.0.48

0.0.47

0.0.46

0.0.45

0.0.44

0.0.43

0.0.42

0.0.41

0.0.40

0.0.39

0.0.38

0.0.37

0.0.36

0.0.35

0.0.34

0.0.33

0.0.32

0.0.31

0.0.30

0.0.28

0.0.27

0.0.26

0.0.25

0.0.24

0.0.23

0.0.22

0.0.21

0.0.20

0.0.19

0.0.18

0.0.17

0.0.16

0.0.15

0.0.14

0.0.13

0.0.12

0.0.11

0.0.10

0.0.9

0.0.8

0.0.7

0.0.6

0.0.4

0.0.3

0.0.2

0.0.1

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page