Files
LCE-Qt-Launcher/docs/en/RUNNING.md
xgui4 f47c630727 Preparation for release
- update the image of the app and readme
- add new screenshot
- update  workflow with new info,
- update the window installer for both nightly and stable, now the stable version is also a onlline installer,
- delete old note and way more
-  remove dev channel for arch packages, a better way for developpement package will soon be added
- updatrd pyproject.toml
- removed unsused scripts
- new version of the packages helper script s for linux
2026-05-21 15:14:44 -04:00

34 lines
1.6 KiB
Markdown

# How to run
## VSCode
> [!NOTE]
> In Windows you might need to replace `/` with `\`
> [!WARNING]
> This method is not recommed nore tested for NixOS, go to the NixOS Section, for the step for this particular OS.
1. Create a Python Virtual Env via a tool like UV (if not already done)
2. Set VSCode to that Python Virtual Env
3. Run "Pyside : Sync Virtual Env and Launch"
4. Run the app via Vscode debug mode or directly the [`src/lce_qt_launcher/main.py`](src/lce_qt_launcher/main.py) file.
## NixOS
1. load the nix shell with `nix-shell` command
2. compiled the ui and ressource file with [`scripts/build.sh`](scripts/build.sh)
3. load the app with [`python src/lce_qt_launcher/main.py`](src/lce_qt_launcher/main.py)
## FreeBSD
1. Create a virtual Python environment with system access using the command `uv venv --system-site-packages`
2. Synchronize the virtual environment with `uv sync`
3. Activate the virtual environment (replace {.sh} with .sh for bash, .fish for fish, or leave it blank for the POSIX shell) using `source .venv/bin/activate{.sh}`
4. Run the program with the command `python src/lce_qt_launcher/main.py`
## Using the command line
1. Create the venv with uv (`uv sync`)
2. Load the venv with `source .venv/bin/activate.sh` (replace .sh with your shell, on Windows it is `.venv\Scripts\activate.ps1` for powershell or `.venv\Scripts\activate.bat` for cmd)
3. Run `scripts/build.sh` (for Linux) `scripts\build.cmd` for (Windows)
4. Run the main python script `src/lce_qt_launche.py` (On Windows you might need to invoque `python3` directly and replace `/` with `\`)