OptimaLab35-installer/README.md

75 lines
2.4 KiB
Markdown
Raw Normal View History

2025-08-14 18:58:45 +02:00
# OptimaLab35 Installer
2025-08-14 16:46:59 +02:00
2025-08-14 18:58:45 +02:00
This is a Linux installation script for **[OptimaLab35](https://code.boxyfoxy.net/CodeByMrFinchum/OptimaLab35)**.
It will:
2025-08-14 18:58:45 +02:00
- Install **Micromamba** with default settings (if its not already installed in the default path).
- Create a Micromamba environment containing **OptimaLab35** (installed via `pip`).
- Create a desktop shortcut for launching OptimaLab35.
If you do **not** want to use Micromamba or have it installed in a different location, see **line 41** of the installer script (where `$DESKTOP_DIR/OptimaLab35.desktop` is created) and adjust accordingly.
2025-11-03 14:23:44 +01:00
This script is **not** meant to be a universal installer for all Python environments - its tailored for my setup using Micromamba for quick deployment with a desktop shortcut.
2025-08-14 18:58:45 +02:00
---
## Usage
Run this in a terminal:
```bash
"${SHELL}" <(curl -L https://code.boxyfoxy.net/CodeByMrFinchum/OptimaLab35-installer/raw/branch/main/OL35-installer.sh)
```
2025-08-14 18:58:45 +02:00
**Tip:** You can paste the URL into your browser to review the script before running it - you should never blindly execute random scripts from the internet.
---
## How to Update OptimaLab35
OptimaLab35 includes a built-in updater:
1. Open the **Settings** menu.
2. Click **Check for update**.
3. If an update is available, click **Update** and restart the application.
---
## How it Works
1. **Micromamba Check**
- If `micromamba` is not found in its default location (`~/micromamba`), it is installed automatically using:
```bash
"${SHELL}" <(curl -L micro.mamba.pm/install.sh)
```
2025-11-03 14:23:44 +01:00
- During installation, **use the default settings** - just press Enter for each prompt (binary folder, init shell, configure conda-forge, and prefix location).
2025-08-14 18:58:45 +02:00
2. **Environment Creation**
- A Micromamba environment named `ol` is created (or updated) and OptimaLab35 is installed into it via `pip`.
3. **Configuration Setup**
- A configuration directory is created at:
```
~/.config/OptimaLab35
```
- A logo image is downloaded from the repository for use in the desktop shortcut.
4. **Desktop Shortcut Creation**
- A `.desktop` file is placed in:
```
~/.local/share/applications/
```
- This allows you to launch OptimaLab35 from your systems application menu.
---
## GAI Disclaimer
ChatGPT was used for discussion and code generation in this project - including both Bash snippets and English language improvements.