| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| dcore:sce-ondemand_command [2016/05/14 04:04] – nitram | dcore:sce-ondemand_command [2016/08/31 05:42] (current) – nitram |
|---|
| ===== dCore sce-ondemand Command ===== | ===== dCore sce-ondemand Command ===== |
| |
| The sce-ondemand command is used to manage ondemand SCE(s). | The sce-ondemand command is used to manage OnDemand SCE(s). Adding an SCE to OnDemand creates an application entry in the (supported) Window Manager's OnDemand menu and auto generates a script in /etc/sysconfig/tcedir/ondemand/, example: |
| | <code> |
| | #!/bin/sh |
| | ondemand -e firefox.sce |
| | </code> |
| |
| Process: | This command loads and launches the SCE through a desktop file, found in /usr/local/share/applications/, or by directly issuing ''exec''. A pop-up message indicating //'Neither freedesktop file nor App executable exists. Please invoke from terminal or menu'// when attempting to launch an OnDemand extension usually means the application does not have a desktop file and is meant to be executed from command line. |
| *Adding an SCE to ondemand: | |
| *Creates an application entry in the Window Manager's 'ondemand' menu. | |
| *Adds a file in /etc/sysconfig/tcedir/ondemand/ containing the command to be executed. | |
| *A standard 'ondemand' file contains the following, which may be customized by the user if needed: | |
| <code>ondemand -e <EXTENSION></code> | |
| *This command loads and launches the SCE's executable either through a '.desktop' file found in /usr/local/share/applications/ or by direclty issuing ''exec''. | |
| *A "Neither freedesktop file nor App executable exists. Please invoke from terminal or menu." pop-up message when attempting to launch an 'ondemand' extension typically means the application does not have a '.desktop' file, often an application meant to run from a command line. The user may wish to manually modify the SCE's 'ondemand' file, similar to below: | |
| <code>sce-load <EXTENSION> | |
| exec <APPLICATION></code> | |
| |
| This may be necessary, for instance, if the ondemand item is created for an extension built after a list of packages and the name of the list does not correspond to the executable. To avoid such hassle it seems advisable to generally name extension list after their main executable. | The contents of the OnDemand script may be manually modified to fix application launch issues or customize functionality. For example, this modified qpdfview OnDemand script ensures newly opened PDF documents open in tabbed mode: |
| | <code> |
| | #!/bin/sh |
| | #ondemand -e qpdfview.sce |
| | sce-load qpdfview && qpdfview --unique |
| | </code> |
| |
| | If creating SCEs from list files (see sce-import -l command) it may be easiest to name the list file, and subsequent created SCE name, after the main executable to ensure it launches properly from an OnDemand menu. |
| |
| Usage options from the 'sce-ondemand --help' command: | The ''sce-ondemand'' command is a symlink evolved from ''ondemand'', simply running ''ondemand SCE'' is a shortcut to quickly add an existing SCE to OnDemand, example: |
| | <code> |
| | ondemand firefox |
| | </code> |
| | |
| | The easiest way to add an application to OnDemand is during the import process, review ''sce-import --help'' regarding ''sce-import -o'' (OnDemand). |
| | |
| | As OnDemand is in dCore's default application path, OnDemand applications are accessible with terminal tab auto-complete prior to loading. In most cases, issuing the application's executable command, via terminal or Window Manager menu, will auto-load and immediately execute the application. |
| | <code> |
| | tc@box:~$ echo $PATH |
| | /home/tc/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/bb:/etc/sysconfig/tcedir/ondemand |
| | </code> |
| | |
| | Usage options from the ''sce-ondemand --help'' command: |
| |
| sce-ondemand - Manage ondemand SCE(s). Adding an SCE to ondemand creates a | sce-ondemand - Manage ondemand SCE(s). Adding an SCE to ondemand creates a |
| ondemand menu, which provides a convenient way to load | ondemand menu, which provides a convenient way to load |
| less frequently used SCE(s) after boot. | less frequently used SCE(s) after boot. |
| | |
| Usage: | Usage: |
| | |
| sce-ondemand SCE Add SCE to ondemand, update menus. | sce-ondemand SCE Add SCE to ondemand, update menus. |
| sce-ondemand -c Display current ondemand SCE(s). | sce-ondemand -c Display current ondemand SCE(s). |
