/ulauncher-jetbrains

Open your Jetbrains recent projects from Ulauncher

Primary LanguagePythonMIT LicenseMIT

Ulauncher Jetbrains

Ulauncher Extension CI Status License

Open your recent projects from Jetbrains based IDEs from ulauncher.

Demo

demo

Requirements

  • Ulauncher 5
  • Python >= 3
  • The Jetbrains IDE you want to use.

Install

Open ulauncher preferences window -> extensions -> add extension and paste the following url:

https://github.com/brpaz/ulauncher-jetbrains

Usage

The following Jetbrains IDEs are supported:

  • PHPStorm
  • WebStorm
  • PyCharm
  • IntelliJ IDEA
  • GoLand
  • CLion
  • Android Studio
  • Rider
  • RubyMine

Before using this extension, you must create a command line launcher for your Jetbrains IDE. For that you can go to "Tools -> Create Command Line Launcher" in your IDE. After that, you should configure the path to the created launcher in the plugin settings.

You also need to configure the path of your IDE "recentProjects" file in the plugin settings. The path is something like "~/.PhpStorm2018.1/config/options/recentProjectDirectories.xml". You will probably just need to change the ".PhpStorm2018.1/" part to match your IDE version.

Development

git clone https://github.com/brpaz/ulauncher-brotab
make link

The make link command will symlink the cloned repo into the appropriate location on the ulauncher extensions folder.

To see your changes, stop ulauncher and run it from the command line with: make dev.

The output will display something like this:

2020-11-15 10:24:16,869 | WARNING | ulauncher.api.server.ExtensionRunner: _run_process() | VERBOSE=1 ULAUNCHER_WS_API=ws://127.0.0.1:5054/ulauncher-jetbrains PYTHONPATH=/usr/lib/python3.8/site-packages /usr/bin/python3 /home/bruno/.local/share/ulauncher/extensions/ulauncher-jetbrains/main.py

Open another terminal window and execute the command displayed, "starting at VERBOSE=1". This will activate the extension.

To see your changes, CTRL+C the previous command and run it again to refresh.

FAQ

My extension doesnt install: Key Error

This error usually indicates a missing Python package in your system. Please read.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

💛 Support the project

If this project was useful to you in some form, I would be glad to have your support. It will help to keep the project alive and to have more time to work on Open Source.

The sinplest form of support is to give a ⭐️ to this repo.

You can also contribute with GitHub Sponsors.

GitHub Sponsors

Or if you prefer a one time donation to the project, you can simple:

Buy Me A Coffee

Author

👤 Bruno Paz

📝 License

Copyright © 2020 Bruno Paz.

This project is MIT licensed.