Gaucho

by @angrykoala

Minimalistic task launcher

Boost your productivity by running commands, scripts, and applications with one click.

Gaucho 0.6.1

Features

• Easily run commands using a simple GUI.
• Schedule your tasks.
• Available for Windows, Linux and Mac.
• Import/Export tasks.
• Handy log output.
• Themes.

Download

Gaucho is available for Windows, Mac and Linux. It can be downloaded on the following links:

• Official Releases (All versions)
• Snap store (Linux)
• Softpedia (Windows)

If you need a different version, please, follow the development instructions to make your own build from the source code or leave an issue.

Usage

Gaucho is organized through configurable tasks that belong to Suites. Each task can be easily configured by providing a name and command. Tasks can be executed independently, or the whole suite can be executed as once.

Executing tasks

On each suite, you will find the list of possible tasks to launch. By clicking on Run you will start that task. Clicking the same button again (now the Stop button) will stop the task.

You can easily see the name, execution time and status of each task. The status (shown with the status icon) can be idle (black), running (blue), successful (green) or failed (red).

Clicking in the task name the log will be displayed, allowing you to check the task output in real time.

A task can also be scheduled through the context menu. This menu also allows to perform some of the actions described above.

Creating and Editing tasks

By clicking the Edit button (on the top right corner) you'll be able to edit the suites and tasks (edit mode).

You can add new tasks to the current suite by clicking "Add New Task" at the bottom of the list. By clicking on a task name you'll be able to edit that task.

While editing/creating a new tasks, you should add a name to the task and a command. The command can be any shell/terminal accepted command or an executable file. Optionally a path can be added as well, if no path is added, default user path will be used.

The tasks can be deleted by clicking the Delete button. In this mode you can also move tasks (clicking on the drag handle), reorder suites, create suites (+ button), delete and rename suites and tasks (through the context menu)

Context Menu

The Context menu can be accessed by clicking on the secondary button of the mouse, depending on where is clicked (task or suite), different actions will appear. These actions will not change whether you are in edit mode or not.

Main Menu

Next to the edit button, is the menu button. When clicking the menu, several options will be shown, those options may change depending if the edit mode is active or not. This menu allows you to go to the settings menu, quit the application, or perform actions over the current selected suite.

User and Tasks Configuration

All tasks and user changes are saved automatically on real time. This includes all the tasks/suites information as well as the window size.

Settings

In the settings menu, you'll be able to configure how Gaucho looks (themes and some display options). You can also export and import all your suites to a file (useful to share or sync tasks between multiple Gaucho applications). Keep in mind that importing tasks will delete all currently existing tasks

Development

If you want to contribute to Gaucho, create a new different version of Gaucho, or compile it from source code, follow these instructions.

Node 10.16.0 or higher recommeded

Clone/download source code from the GitHub. Make sure you have node and npm already installed in your system:

1. npm install to install electron and all the dependencies.
2. npm run start-dev to run gaucho in dev mode with chrome dev tools enabled.
3. npm run dist to build and package gaucho for your system. The artifacts are located in dist/.
   • If you encounter a problem while building, please, check Common Issues
4. npm run dist-all to build and package gaucho for all supported architectures and platforms, it will take a while.
   • Some dependencies may need installing, depending on the system, check the troubleshooting page
5. npm test to run the automated tests.
   • npm run eslint to run eslint to check code style.
   • Please, ensure the tests and linter are passing before creating a pull requests. Add tests for your changes.

• To install snap version locally: snap install --dangerous gaucho_0.6.3_amd64.deb
• Use npm run pack to execute a lightweight built with just the basic version of your OS

Release to snap:

1. snapcraft login
2. snapcraft push Gaucho_0.6.0_amd64.snap --release=stable

Only for collaborators!!

Troubleshooting

Check Troubleshooting Page

Acknowledgments

• @aebsubis for designing Gaucho Logo.
• Electron framework was used for the app development.

License

Gaucho is being developed and maintained as Open-Source software by @angrykoala (https://github.com/angrykoala) licensed under GNU GENERAL PUBLIC LICENSE version 3

The original source code can be found at: https://github.com/angrykoala/gaucho

You can find more information about Gaucho in the official wiki