{"id":13432397,"url":"https://github.com/jonathanhogg/flitter","last_synced_at":"2025-04-05T22:10:53.845Z","repository":{"id":119303348,"uuid":"583753336","full_name":"jonathanhogg/flitter","owner":"jonathanhogg","description":"A functional programming language and declarative system for describing 2D and 3D visuals","archived":false,"fork":false,"pushed_at":"2025-03-28T08:06:47.000Z","size":47713,"stargazers_count":61,"open_issues_count":14,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-29T21:06:55.886Z","etag":null,"topics":["ableton-push2","dmx","flitterlang","glsl","language","lasers","lighting-control","live-coding","live-performance","live-visuals","livecoding","midi-controller","opengl","visuals"],"latest_commit_sha":null,"homepage":"https://flitter.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonathanhogg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":"FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["jonathanhogg"]}},"created_at":"2022-12-30T20:00:31.000Z","updated_at":"2025-03-28T08:06:51.000Z","dependencies_parsed_at":"2023-10-11T12:56:48.754Z","dependency_job_id":"e82e8b12-4374-4c2e-a1f5-969bb2e3e11b","html_url":"https://github.com/jonathanhogg/flitter","commit_stats":null,"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonathanhogg%2Fflitter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonathanhogg%2Fflitter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonathanhogg%2Fflitter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonathanhogg%2Fflitter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonathanhogg","download_url":"https://codeload.github.com/jonathanhogg/flitter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406111,"owners_count":20933806,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ableton-push2","dmx","flitterlang","glsl","language","lasers","lighting-control","live-coding","live-performance","live-visuals","livecoding","midi-controller","opengl","visuals"],"created_at":"2024-07-31T02:01:11.132Z","updated_at":"2025-04-05T22:10:53.825Z","avatar_url":"https://github.com/jonathanhogg.png","language":"Python","funding_links":["https://github.com/sponsors/jonathanhogg"],"categories":["Python"],"sub_categories":[],"readme":"![Screenshot from a Flitter program showing colourful distorted ellipse shapes\nwith trails moving outwards from the centre of the screen.](https://github.com/jonathanhogg/flitter/raw/main/docs/header.jpg)\n\n# Flitter\n\n[![CI lint](https://github.com/jonathanhogg/flitter/actions/workflows/ci-lint.yml/badge.svg?)](https://github.com/jonathanhogg/flitter/actions/workflows/ci-lint.yml)\n[![CI test](https://github.com/jonathanhogg/flitter/actions/workflows/ci-test.yml/badge.svg?)](https://github.com/jonathanhogg/flitter/actions/workflows/ci-test.yml)\n[![CI coverage](https://gist.githubusercontent.com/jonathanhogg/b7237d8b4e7ff50c3f284cb939e949d0/raw/badge.svg?)](https://github.com/jonathanhogg/flitter/actions/workflows/ci-coverage.yml)\n[![docs](https://readthedocs.org/projects/flitter/badge/?version=latest)](https://flitter.readthedocs.io/en/latest/?badge=latest)\n\n**Flitter** is a functional programming language and declarative system for\ndescribing 2D and 3D visuals. It is designed to encourage an iterative,\nexplorative, play-based approach to constructing visuals.\n\n[The language](https://flitter.readthedocs.io/en/latest/language.html) supports\nthe basic range of functional language features: first-class recursive and\nanonymous functions, comprehensions, let/where, conditional expressions, lists\n(\"vectors\"). However, unusually, all values are vectors and all operators are\nelement-wise, and the language is built around constructing trees of attributed\nnodes. The language is designed to be familiar to Python programmers.\n\nThe engine is able to live reload all code and assets (including any shaders,\nimages, videos, models, etc.) while retaining the current system state - thus\nsupporting live-coding. It also has support for interacting with running\nprograms via MIDI surfaces (plus basic pointer and keyboard support).\n\n**Flitter** is implemented in a mix of Python and Cython and requires at least\nOpenGL 3.3 (Core Profile) or OpenGL ES 3.0. At least Python 3.10 is also\nrequired as the code uses `match`/`case` syntax.\n\n**Flitter** is designed for expressivity and ease of engine development over\nraw performance, but is fast enough to be able to do interesting things.\n\nThe engine that runs the language is capable of:\n\n- [2D drawing](https://flitter.readthedocs.io/en/latest/canvas.html) (loosely\n  based on an HTML canvas/SVG model)\n- [3D rendering](https://flitter.readthedocs.io/en/latest/canvas3d.html),\n  including:\n  - primitive box, sphere, cylinder and cone shapes\n  - external triangular mesh models in a variety of formats including OBJ\n    and STL\n  - planar trimming, union, difference and intersection of solid models\n  - construction of meshes from signed distance fields, including common\n    combinators and blending functions, and the ability to specify custom\n    functions\n  - ambient, directional, point/sphere, line/capsule and spotlight sources\n    (currently shadowless)\n  - multiple (simultaneous) cameras with individual control over location,\n    field-of-view, clip planes, render buffer size, color depth, MSAA samples,\n    perspective/orthographic projection, fog, conversion to monochrome and\n    colour tinting\n  - PBR forward-rendering pipeline with emissive objects, transparency and\n    translucency, plus the ability to plug in custom GLSL shaders for arbitrary\n    groups of objects\n  - texture mapping, including with the output of other visual units (e.g., a\n    drawing canvas or a video)\n- simulating [physical particle\n  systems](https://flitter.readthedocs.io/en/latest/physics.html), including\n  spring/rod/rubber-band constraints, gravity, electrostatic charge, adhesion,\n  buoyancy, inertia, drag (including in flowing media), Brownian motion,\n  uniform electric fields, barriers and particle collisions\n- [playing videos](https://flitter.readthedocs.io/en/latest/windows.html#video)\n  at arbitrary speeds (including in reverse)\n- running [GLSL\n  shaders](https://flitter.readthedocs.io/en/latest/shaders.html) as\n  stacked image filters and generators, with per-frame control of arbitrary\n  uniforms, and support for multi-pass and downsampling\n- built-in filters for: scaling/translating/rotating, Gaussian blurring, bloom,\n  edge detection, vignetting, video feedback, lens flares, color and exposure\n  adjustments, tone-mapping with the Reinhard and ACES Filmic functions, and 2D\n  noise-map generation\n- compositing all of the above and rendering to one or more windows\n- [saving rendered\n  output](https://flitter.readthedocs.io/en/latest/windows.html#record) to\n  image and video files (including lockstep frame-by-frame video output\n  suitable for producing perfect loops and direct generation of animated GIFs)\n- taking live inputs from Ableton Push 2 or Behringer X-Touch mini MIDI\n  surfaces (other controllers relatively easy to add)\n- driving arbitrary DMX fixtures via an Entec-compatible USB DMX interface\n- driving a LaserCube plugged in over USB (other lasers probably easy-ish to\n  support)\n\n**Flitter** also has a plug-in architecture that allows extension with new\nimage and 3D mesh generators, MIDI and DMX interfaces, or completely novel\ninput and output systems.\n\n## Installation\n\n**Flitter** can be installed from the [`flitter-lang` PyPI\npackage](https://pypi.org/project/flitter-lang/)  with:\n\n```sh\npip3 install flitter-lang\n```\n\nand then run as:\n\n```sh\nflitter path/to/some/flitter/script.fl\n```\n\nMore details can be found in the [installation\ndocumentation](https://flitter.readthedocs.io/en/latest/install.html).\n\n## Documentation\n\nThe documentation is available on [**Read** *the*\n**Docs**](https://flitter.readthedocs.io/).\n\nThere are a few quick\n[examples](https://github.com/jonathanhogg/flitter/blob/main/examples)\nin the main repository. However, there is also a separate repo containing [many\nmore interesting examples](https://github.com/jonathanhogg/flitter-examples)\nthat are worth checking out.\n\n## License\n\n**Flitter** is copyright © Jonathan Hogg and licensed under a [2-clause\n\"simplified\" BSD\nlicense](https://github.com/jonathanhogg/flitter/blob/main/LICENSE)\nexcept for the OpenSimplex 2S noise implementation, which is based on\n[code](https://code.larus.se/lmas/opensimplex) copyright © A. Svensson and\nlicensed under an [MIT\nlicense](https://code.larus.se/lmas/opensimplex/src/branch/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonathanhogg%2Fflitter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonathanhogg%2Fflitter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonathanhogg%2Fflitter/lists"}