Metadata-Version: 2.4
Name: fujielab-util-launcher
Version: 0.2.2
Summary: Fujielab Utility Launcher GUI
Author-email: Shinya Fujie <shinya.fujie@p.chibakoudai.jp>
Maintainer-email: Shinya Fujie <shinya.fujie@p.chibakoudai.jp>
License: Apache-2.0
Project-URL: Homepage, https://github.com/fujielab/fujielab-util-launcher
Project-URL: Bug Tracker, https://github.com/fujielab/fujielab-util-launcher/issues
Project-URL: Documentation, https://github.com/fujielab/fujielab-util-launcher#readme
Project-URL: Source Code, https://github.com/fujielab/fujielab-util-launcher
Keywords: launcher,gui,utility
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Utilities
Classifier: Environment :: X11 Applications :: Qt
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PyQt5>=5.15.0
Requires-Dist: PyYAML>=6.0
Dynamic: license-file

# fujielab-util-launcher

Multiple Program Launcher Utility

[日本語のREADME](README.ja.md)

## Usage

### How to Run

```
fujielab-launcher [options]
```

#### Options

- `-d`, `--debug`: Enable debug mode. Detailed log messages will be displayed.
- `-r`, `--reset-config`: Initialize the launcher to start with no saved settings from the previous session.
- `-c`, `--config`: Start with settings imported from a previously exported configuration file.
- `--version`: Display version information and exit.
- `--lang`: Select UI language (`en` or `ja`). If omitted, the system locale is
  used.
- `--create-shortcut`: Create a shortcut on Windows (Desktop) or macOS (Applications folder).
- `-h`, `--help`: Display help message and exit.

### Debug Mode

In debug mode, detailed information about the application's operation is displayed.
Detailed logs are output for operations such as saving and loading configuration files,
changing window states, starting and stopping processes, etc.

This is useful for development and troubleshooting. It is not necessary for normal use.

```bash
# Start in debug mode
fujielab-launcher -d
```

### Using Custom Configuration File

You can start with previously exported settings by using the `-c` or `--config` option.

```bash
fujielab-launcher --config /path/to/your/custom_config.yaml
```

This is useful for switching between different configuration profiles or importing settings from another system.

### Creating Shortcuts

You can create a shortcut for quick access. On Windows this is placed on the Desktop, while on macOS it will be created in the Applications folder:

```cmd
fujielab-launcher --create-shortcut
```

This will create a shortcut on your Desktop (Windows) or in the Applications folder (macOS) that launches the program directly. On Windows, this option requires the `pywin32` package to be installed:

```cmd
pip install pywin32
```

## Features

- Multiple program launcher with configurable settings
- Support for Python scripts and shell commands
- Ability to pass command line arguments to Python scripts
- Customizable workspace directory settings
- Cross-platform support (Windows, macOS, Linux)

## Installation

### From PyPI

```bash
pip install fujielab-util-launcher
```

### From Source

```bash
git clone https://github.com/fujielab/fujielab-util-launcher.git
cd fujielab-util-launcher
pip install -e .
```

## License

Apache License 2.0
