TexnoMagic is a free and open source Python 3 library and format for magic symbol recognition and symbol-based language parsing.
I created TexnoMagic after prototyping serveral systems for magic symbol recognition and invocation as well as systems for creating magic language based on symbols.
You can read my posts about
to get a better idea of what I'm trying to achieve.
- save and load symbols to/from user files
- portable open format based on simple JSON/CSV files
- first user-created alphabets uploaded to wop.mod.io mod portal
- train Gaussian Mixture Models (GMM) from symbol data
- real-time symbol recognition
- spell language parser based of Parsing Expression Grammars (PEG)
- python module from PyPI (
- Command-Line Interface (
- simple TCP server using JSON-RPC (
texnomagic.server) - universal interface
- python module from PyPI (
- ⚠ format and API not stable yet
- ⚠ docs need more content
TexnoMagic is available from PyPI for Python 3.8+:
pip install texnomagic
develop from source as with any other python module.
wopeditor is a project dedicated to providing comprehensive GUI for TexnoMagic.
texnomagic script should be installed, run it without arguments to get a
summary of avaliable commands options:
$> texnomagic Usage: texnomagic [OPTIONS] COMMAND [ARGS]... TexnoMagic CLI Options: --version Show TexnoMagic version and exit. -h, --help Show this message and exit. Commands: check-abcs Check all/selected alphabets for issues. download-mods Download Words of Power mods from wop.mod.io. flip-y Flip Y axis for all symbols in alphabet. list-abcs List all/selected TexnoMagic alphabets. list-mods List online Words of Power mods from wop.mod.io. server Start TexnoMagic TCP server on PORT. spell Parse TexnoMagic spell. train-abcs Train (missing) models for all/selected alphabets.
--help after a command to get usage for that command:
$> texnomagic download-mods -h
If your shell doesn't see the script (i.e. when not in
$PATH), you can invoke
texnomagic.cli module directly:
$> python -m texnomagic.cli list-abcs --full
You can find code examples in:
See reference docs for
texnomagic python module.
Godot Engine ⚙️
You can use Godot's
JSONRPC module to form requests and send them as strings
using standard Godot networking which TexnoMagic adpoted (messages prefixed with
4 bytes of total message length).
You can start universal language-agnostic JSON-RPC over TCP server using
texnomagic server # optionally select a port texnomagic server 12345
You can also invoke texnomagic.server module directly:
python -m texnomagic.server
It's also possible to compile stand-alone
texnomagic binary using PyInstaller:
pyinstaller texnomagic.spec # results in dist/texnomagic
Simple reference python client is provided in texnomagic.client although it's only used for testing in TexnoMagic.
For a full-fledged client implementation see wopeditor.client.
Bugs and Feature Requests
Please use GitHub Issues to report any problems or feature requests.
Contributions, suggestions, and ideas are always welcome ♥
Feel free to drop by #wopeditor @ texnoforge discord.