# Overview
LaunchPanel is a simple interface designed to expose LaunchPad Actions
to the user in an intuitive way.
LaunchActions are displayed in icon-centric list widgets, and they are
organised into tabs based on their groups. The user has the ability to
define tab orientation, icon size and plugin locations.
Video demo coming soon...
# Installation
If you use pip, you can simply run ```pip install launchpanel```. That will
pull down the required dependencies (qute, scribble & factories) automatically.
Alternatively, if you just want to download a file and extract everything to a
location you can download __packaged_launchpanel.zip__ and extract the contents
of that zip to somewhere where your python interpreter/application is looking
for python modules.
If you want to look at some example plugins - some of which use simple static
data in their plugin whilst others dynamically generate plugins at runtime, you
can pull down the __example_plugins__ folder.
# Running
You can run launchpanel by calling:
```python
import launchpanel
launchpanel.launch()
```
This code will work in both standalone python as well as supported applications
such as Max, Maya and Motion Builder (see details of qute for full list of
application support https://github.com/mikemalinowski/qute)
If you want to easily run Launch Panel in standalone for everyday use on
windows the easiest thing to do is to create a .cmd file on your desktop with
the following in it:
```call c:\python27\pythonw.exe /my/path/to/launchpand/run.py```
# Environments
If you're using launchpanel in multiple contexts it can be useful to
differentiate one from the other. This can be done by setting the
environment_id.
This is simply a string identifier which defines where it will store its
settings/preferences.
```python
import launchpanel
launchpanel.launch(environment_id='foo')
```
The above instance will not cross over with the instance created below, meaning
each can have their own paths to look for actions.
```python
import launchpanel
launchpanel.launch(environment_id='bar')
```
This is particulary useful if you are running multiple projects and want a
bespoke set of plugins displayed for each one.
## Dependencies
This module has the following dependencies:
* launchpad
* qute
* scribble (pip install scribble)
# Credits & Collaboration
This module was inspired by some excellent collaborative projects with a
fantastic tech-artist called __Toby Harrison-Banfield__.
I am always open to collaboration, so if you spot bugs lets me know, or if
you would like to contribute or get involved just shout!
# Compatibility
Launchpad has been tested under Python 2.7 and Python 3.7 on Windows and Ubuntu.
Raw data
{
"_id": null,
"home_page": "https://github.com/mikemalinowski/launchpad",
"name": "launchpanel",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "launch launchpad pad action actions launchpanel panel",
"author": "Mike Malinowski",
"author_email": "mike.malinowski@outlook.com",
"download_url": "https://files.pythonhosted.org/packages/55/92/07f35933b1d5a575473bdbf9a8d3f6c02032d30622e890de6fb245eeeaa1/launchpanel-2.0.1.tar.gz",
"platform": null,
"description": "\r\n# Overview\r\n\r\n\r\nLaunchPanel is a simple interface designed to expose LaunchPad Actions\r\nto the user in an intuitive way.\r\n\r\nLaunchActions are displayed in icon-centric list widgets, and they are\r\norganised into tabs based on their groups. The user has the ability to\r\ndefine tab orientation, icon size and plugin locations.\r\n\r\nVideo demo coming soon...\r\n\r\n\r\n# Installation\r\n\r\nIf you use pip, you can simply run ```pip install launchpanel```. That will \r\npull down the required dependencies (qute, scribble & factories) automatically.\r\n\r\nAlternatively, if you just want to download a file and extract everything to a \r\nlocation you can download __packaged_launchpanel.zip__ and extract the contents\r\nof that zip to somewhere where your python interpreter/application is looking\r\nfor python modules.\r\n\r\nIf you want to look at some example plugins - some of which use simple static\r\ndata in their plugin whilst others dynamically generate plugins at runtime, you\r\ncan pull down the __example_plugins__ folder.\r\n\r\n# Running\r\n\r\nYou can run launchpanel by calling:\r\n\r\n```python\r\nimport launchpanel\r\nlaunchpanel.launch()\r\n```\r\n\r\nThis code will work in both standalone python as well as supported applications\r\nsuch as Max, Maya and Motion Builder (see details of qute for full list of\r\napplication support https://github.com/mikemalinowski/qute)\r\n\r\nIf you want to easily run Launch Panel in standalone for everyday use on\r\nwindows the easiest thing to do is to create a .cmd file on your desktop with\r\nthe following in it: \r\n\r\n```call c:\\python27\\pythonw.exe /my/path/to/launchpand/run.py```\r\n\r\n\r\n# Environments\r\n\r\n\r\nIf you're using launchpanel in multiple contexts it can be useful to\r\ndifferentiate one from the other. This can be done by setting the\r\nenvironment_id.\r\n\r\nThis is simply a string identifier which defines where it will store its\r\nsettings/preferences.\r\n\r\n```python\r\nimport launchpanel\r\nlaunchpanel.launch(environment_id='foo')\r\n```\r\n\r\nThe above instance will not cross over with the instance created below, meaning\r\neach can have their own paths to look for actions.\r\n\r\n```python\r\nimport launchpanel\r\nlaunchpanel.launch(environment_id='bar')\r\n```\r\n\r\nThis is particulary useful if you are running multiple projects and want a\r\nbespoke set of plugins displayed for each one.\r\n\r\n\r\n## Dependencies\r\n\r\n\r\nThis module has the following dependencies:\r\n\r\n * launchpad\r\n * qute\r\n * scribble (pip install scribble)\r\n\r\n\r\n# Credits & Collaboration\r\n\r\nThis module was inspired by some excellent collaborative projects with a \r\nfantastic tech-artist called __Toby Harrison-Banfield__.\r\n\r\nI am always open to collaboration, so if you spot bugs lets me know, or if\r\nyou would like to contribute or get involved just shout!\r\n\r\n\r\n# Compatibility\r\n\r\nLaunchpad has been tested under Python 2.7 and Python 3.7 on Windows and Ubuntu.\r\n",
"bugtrack_url": null,
"license": "",
"summary": "LaunchPanel is a simple interface designed to expose LaunchPad Actions to the user in an intuitive way.",
"version": "2.0.1",
"project_urls": {
"Homepage": "https://github.com/mikemalinowski/launchpad"
},
"split_keywords": [
"launch",
"launchpad",
"pad",
"action",
"actions",
"launchpanel",
"panel"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9bf7bff5400d254246f369ce1d22561fd4d7fa86418bd23f306cfb3634ad3687",
"md5": "c8c63e81c00ac73b36a04687bd07445d",
"sha256": "5a9f30dba65258e266a17dc28f4c0048d7a48855534dad445d42f6b0f2a35acc"
},
"downloads": -1,
"filename": "launchpanel-2.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c8c63e81c00ac73b36a04687bd07445d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 146477,
"upload_time": "2023-05-17T07:54:31",
"upload_time_iso_8601": "2023-05-17T07:54:31.363521Z",
"url": "https://files.pythonhosted.org/packages/9b/f7/bff5400d254246f369ce1d22561fd4d7fa86418bd23f306cfb3634ad3687/launchpanel-2.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "559207f35933b1d5a575473bdbf9a8d3f6c02032d30622e890de6fb245eeeaa1",
"md5": "bb2ea46039bab183f217f10b2fb453bf",
"sha256": "fdd0c1a5635c0a79965b14fc60f861f975cb28fe026d910c5b0cc52a1e11b978"
},
"downloads": -1,
"filename": "launchpanel-2.0.1.tar.gz",
"has_sig": false,
"md5_digest": "bb2ea46039bab183f217f10b2fb453bf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 137819,
"upload_time": "2023-05-17T07:54:33",
"upload_time_iso_8601": "2023-05-17T07:54:33.138217Z",
"url": "https://files.pythonhosted.org/packages/55/92/07f35933b1d5a575473bdbf9a8d3f6c02032d30622e890de6fb245eeeaa1/launchpanel-2.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-17 07:54:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mikemalinowski",
"github_project": "launchpad",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "launchpanel"
}