An open API service indexing awesome lists of open source software.

https://github.com/pforret/shlaunch

Launch desktop/GUI apps from CLI (e.g. Chrome, PHPStorm, Photoshop ...)
https://github.com/pforret/shlaunch

bash bashew launcher macos

Last synced: 13 days ago
JSON representation

Launch desktop/GUI apps from CLI (e.g. Chrome, PHPStorm, Photoshop ...)

Awesome Lists containing this project

README

          

![bash_unit CI](https://github.com/pforret/shlaunch/workflows/bash_unit%20CI/badge.svg)
![Shellcheck CI](https://github.com/pforret/shlaunch/workflows/Shellcheck%20CI/badge.svg)
![GH Language](https://img.shields.io/github/languages/top/pforret/shlaunch)
![GH stars](https://img.shields.io/github/stars/pforret/shlaunch)
![GH tag](https://img.shields.io/github/v/tag/pforret/shlaunch)
![GH License](https://img.shields.io/github/license/pforret/shlaunch)
[![basher install](https://img.shields.io/badge/basher-install-white?logo=gnu-bash&style=flat)](https://basher.gitparade.com/package/)

# shlaunch

![](assets/launch.jpg)

Start applications like Lightroom/Sublime Text/Chrome from CLI

## 🔥 Usage

```
Program: shlaunch 0.1.3 by peter@forret.com
Updated: Apr 18 09:32:42 2021
Description: Run applications from CLI
Usage: shlaunch [-h] [-q] [-v] [-l ]
Flags, options and parameters:
-h|--help : [flag] show usage [default: off]
-q|--quiet : [flag] no output [default: off]
-v|--verbose : [flag] output more [default: off]
-l|--log_dir > : [option] folder for log files [default: /Users/pforret/log/shlaunch]
: [parameter] program to start: phpstorm/spotify/... (optional)
: [parameter] parameters to start program with (optional)

### TIPS & EXAMPLES
* use shlaunch [application] [folder/file] to start the application
shlaunch phpstorm .
* use [alias] [folder/file] to start the [alias] application (alias = symlink to shlaunch)
phpstorm .
lightroom Photos/IMG1243547.dng
* use shlaunch check to check if this script is ready to execute and what values the options/flags are
shlaunch check
* use shlaunch env to generate an example .env file
shlaunch env > .env
* use shlaunch update to update to the latest version
```

There are aliases (symbolic links) that facilitate usage.
E.g. `firefox www.google.com` is equivalent to `shlaunch firefox www.google.com`,
because of the pre-existing symbolic link `ln -s shlaunch.sh firefox`.

## Applications supported

| application | alias | MacOS | Ubuntu | Fedora |
|-------------------------------------------------------------------------------|-------------|-------|--------|--------|
| [Adobe Lightroom](https://www.adobe.com/products/photoshop-lightroom.html) | _lightroom_ | ✅ | - | - |
| [Adobe Photoshop](https://www.adobe.com/products/photoshop.html) | _photoshop_ | ✅ | - | - |
| [Apple Safari](https://www.apple.com/safari/) | _safari_ | ✅ | - | - |
| [Filezilla](https://filezilla-project.org/) | _filezilla_ | ✅ | - | - |
| [Mozilla Firefox](https://www.mozilla.org/firefox/) | _firefox_ | ✅ | - | - |
| [Google Chrome](https://www.google.com/chrome/) | _chrome_ | ✅ | - | - |
| [Jetbrains PhpStorm](https://www.jetbrains.com/phpstorm/) | _phpstorm_ | ✅ | - | - |
| [Sublime Text](https://www.sublimetext.com/) | _sublime_ | ✅ | - | - |

## ⌨️ Examples

```bash
> phpstorm .
# start PhpStorm with current folder as project

> safari www.google.com
# open Safari with Google website
```

## 🚀 Installation

with [basher](https://github.com/basherpm/basher)

$ basher install pforret/shlaunch

or with `git`

$ git clone https://github.com/pforret/shlaunch.git
$ cd shlaunch

## 📝 Acknowledgements

* script created with [bashew](https://github.com/pforret/bashew)

© 2021 [Peter Forret](https://github.com/pforret)