Difference between revisions of "Adding new computing apps"

From LinuxMCE
Jump to: navigation, search
 
 
(8 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<table width="100%"> <tr><td bgcolor="#FFCFCF">This page was written by Pluto and imported with their permission when LinuxMCE branched off in February, 2007.  In general any information should apply to LinuxMCE.  However, this page should be edited to reflect changes to LinuxMCE and remove old references to Pluto.</td></tr> </table>In the "computing" screen, one can add new applications.
+
[[Category:Installation Tutorials]]
 +
 
 +
In the "computing" screen can be added new applications.
  
 
To add a new application, a template must be used, and the window class for that application must be known.
 
To add a new application, a template must be used, and the window class for that application must be known.
Line 6: Line 8:
 
The WM_CLASS property (of type STRING without control characters) contains two consecutive null-terminated strings. These specify the Instance and Class names to be used by both the client and the window manager for looking up resources for the application or as identifying information.
 
The WM_CLASS property (of type STRING without control characters) contains two consecutive null-terminated strings. These specify the Instance and Class names to be used by both the client and the window manager for looking up resources for the application or as identifying information.
  
==On a pluto computer==
+
==On a LinuxMCE computer==
 +
 
 
Go to computing screen.
 
Go to computing screen.
  
Line 24: Line 27:
 
Press Ctrl-Alt-F3 and log in again
 
Press Ctrl-Alt-F3 and log in again
  
type these commands (without $)
+
type these commands
 
     export DISPLAY=:0
 
     export DISPLAY=:0
 
     xprop | grep WM_CLASS
 
     xprop | grep WM_CLASS
Line 61: Line 64:
  
 
==Using the WM_CLASS string in the template==
 
==Using the WM_CLASS string in the template==
..... to be written .....
+
 
 +
* A new application can be added to the computing screen from the media director detail page. There is a button ''Edit'' for the ''Computing application'':<br />
 +
[[Image:media-director-page.png|thumb|none|Media Director page]]<br />
 +
* The new popup window - ''Edit Computing Applications'', will be opened with list of all available computing applications:
 +
[[Image:computing-apps-view.png|thumb|none|Edit Computing Applications]]
 +
* Press the link on the bottom of that window to go to edit screen:
 +
[[Image:computing-apps-edit.png|thumb|none|Edit Quick Start templates]]
 +
* There is another link - ''Add quick start template'' on the ''Edit Quick Start templates'' which opens a form:
 +
[[Image:computing-app-add.png|none]]<br />
 +
where you should type '''description''' for your app, the '''path''' to the binary and '''Window class''' from the previous steps. Here is an example for Skype:<br />
 +
[[Image:computing-app-skype.png|none]]
 +
* After submitting that form, close the ''Edit Quick Start templates'' and refresh the page ''Edit Computing Applications''. Then tick the checkbox near added application to activate it, save it and close the window.  
 +
 
 +
That's it. After a quick reloading of router the new application should appear on the left side of the computing screen.
 +
 
 +
===Troubleshooting===
 +
By some reason, after adding new application the path is displayed for each apps on the computing screen instead of description. Probably the Orbiter should be fully regenerated.

Latest revision as of 16:49, 19 October 2012


In the "computing" screen can be added new applications.

To add a new application, a template must be used, and the window class for that application must be known. Window class is a property of every X11 application.

The WM_CLASS property (of type STRING without control characters) contains two consecutive null-terminated strings. These specify the Instance and Class names to be used by both the client and the window manager for looking up resources for the application or as identifying information.

On a LinuxMCE computer

Go to computing screen.

Press admin => firefox should appear

Press Ctrl-Alt-F2 => you are at a login prompt

Log in

run the command

   export DISPLAY=:0

now you can launch GUI applications from this console

   launch your application

Press Ctrl-Alt-F7 and wait until your application appears

Press Ctrl-Alt-F3 and log in again

type these commands

   export DISPLAY=:0
   xprop | grep WM_CLASS

Press Ctrl-Alt-F7 => the cursor changed his shape to "+"

   Click somewhere in your application

=> the cursor changes back to "normal" cursor

Press Ctrl-Alt-F3 and look into your console: a line like this should appear

   WM_CLASS(STRING) = "class_instance", "class_Name"
   class_instance.class_Name is the string that will be used in the template for your application
   Remember this string, and pay attention to lowercase and uppercase characters

You can close your application an your consoles now

On another computer

Launch a terminal

Launch your application

Type in your terminal:

   xprop | grep WM_CLASS

=> the cursor changed his shape to "+"

   Click somewhere in your application

=> the cursor changes back to "normal" cursor

Look in your terminal: a line like this should appear

   WM_CLASS(STRING) = "class_instance", "class_Name"
   class_instance.class_Name is the string that will be used in the template for your application
   Remember this string, and pay attention to lowercase and uppercase characters

You can close your application an your terminal now

Using the WM_CLASS string in the template

  • A new application can be added to the computing screen from the media director detail page. There is a button Edit for the Computing application:
Media Director page

  • The new popup window - Edit Computing Applications, will be opened with list of all available computing applications:
Edit Computing Applications
  • Press the link on the bottom of that window to go to edit screen:
Edit Quick Start templates
  • There is another link - Add quick start template on the Edit Quick Start templates which opens a form:
Computing-app-add.png

where you should type description for your app, the path to the binary and Window class from the previous steps. Here is an example for Skype:

Computing-app-skype.png
  • After submitting that form, close the Edit Quick Start templates and refresh the page Edit Computing Applications. Then tick the checkbox near added application to activate it, save it and close the window.

That's it. After a quick reloading of router the new application should appear on the left side of the computing screen.

Troubleshooting

By some reason, after adding new application the path is displayed for each apps on the computing screen instead of description. Probably the Orbiter should be fully regenerated.