gau

gaucho

Minimalist task launcher

Showing:

Popularity

Downloads/wk

2

GitHub Stars

100

Maintenance

Last Commit

1mo ago

Contributors

24

Package

Dependencies

5

Size (min+gzip)

1.1KB

License

GPL-3.0

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Gaucho

by @angrykoala
Build Status

The Minimalist Task Launcher

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

Gaucho Screenshot
Gaucho 0.6.1

As a developer, it is quite common to repeat the same commands over an over. Running an app, starting a server, compiling your code or building a front-end for example. Most of these are just background tasks that just need to be running, or executed from time to time. Typing the command is slow, and having a terminal per task consumes our precious screen real state. Gaucho provides a simple way to de-clutter your screen by bundling all of those tasks in a simple menu to run and stop these, quick, and simple.

Just add a name, type a command as you would in your terminal, set any env variable or path needed and you are good to go!

Features

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

Download

Gaucho is available for Windows, Mac and Linux.

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 allows you to configure tasks that can be grouped in suites. Each task can be configured by providing a name and command. Tasks can be executed independently, or the whole suite can be executed as once.

Creating and Editing tasks

By clicking the Edit button (top right corner). You'll enter the edit mode that allows you to create, delete, update and move tasks

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)

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.

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.

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.
  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 upload Gaucho_0.6.0_amd64.snap --release=stable

Only for collaborators!!

Troubleshooting

Check Troubleshooting Page

Acknowledgments

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

Get it from the Snap Store

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100