Difference between revisions of "GNOME"

From Organic Design wiki
(debugging and links)
(Extensions: gTile)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{legacy}}
 +
 
[[w:GNOME|GNOME]] offers an easy to understand [[w:Desktop environment|desktop environment]] for your [[GNU/Linux]] or [[w:UNIX|UNIX]] computer.
 
[[w:GNOME|GNOME]] offers an easy to understand [[w:Desktop environment|desktop environment]] for your [[GNU/Linux]] or [[w:UNIX|UNIX]] computer.
  
Line 13: Line 15:
 
*[https://extensions.gnome.org/extension/613/weather/ Weather] ''- at last the old Gnome2 whether is available for Gnome 3!''
 
*[https://extensions.gnome.org/extension/613/weather/ Weather] ''- at last the old Gnome2 whether is available for Gnome 3!''
 
*[https://extensions.gnome.org/extension/754/bitcoin-price/ Bitcoin Price] ''- my first Gnome extension which adds the current [[Bitcoin]] price to the main panel''
 
*[https://extensions.gnome.org/extension/754/bitcoin-price/ Bitcoin Price] ''- my first Gnome extension which adds the current [[Bitcoin]] price to the main panel''
 +
*[https://extensions.gnome.org/extension/28/gtile/ gTile] ''- a good window tiling extension''
  
 
=== Writing extensions ===
 
=== Writing extensions ===
The execution output of the extension code is logged to '''~/.cache/gdm/session.log''', and you can insert custom entries into it from your code using the '''global.log("text")''' method. Here's some useful links for developing extensions:
+
Create an initial working extension template using the '''gnome-shell-extension-tool --create-extension''' command, then after you change your code, you restart the Gnome shell by pressing '''ALT+F2''', then entering '''r''' and pressing ''Enter''. To check for errors and perform other debugging tasks, use the [https://wiki.gnome.org/Projects/GnomeShell/LookingGlass LookingGlass] applet which can be started by pressing '''ALT+F2''', then entering '''lg''' and pressing ''Enter'', and ''escape'' to close it. Use the command '''global.log("text")''' in your code to output to the error console which you can view from ''LookingGlass'' in the ''errors'' tab - not that it doesn't update in real-time.
*[https://wiki.gnome.org/GnomeShell/Extensions/StepByStepTutorial A list of many tutorials on the GNOME wiki]
+
*[http://blog.mecheye.net/2012/02/requirements-and-tips-for-getting-your-gnome-shell-extension-approved/ Requirements and tips for getting your GNOME Shell Extension approved]
 +
*[https://wiki.gnome.org/Projects/GnomeShell/Extensions/StepByStepTutorial Step by step tutorial to create extensions on the GNOME wiki]
 
*[http://www.tangazenileo.com/blog/2013/02/10/gnome-3-extension-development-hints-4-custom-icon-to-main-panel/ Add a custom icon to the main panel]
 
*[http://www.tangazenileo.com/blog/2013/02/10/gnome-3-extension-development-hints-4-custom-icon-to-main-panel/ Add a custom icon to the main panel]
 
*[http://www.tangazenileo.com/blog/2013/03/16/gnome-3-extension-development-hints-6-extension-preferences/ Good example of creating extension prefs]
 
*[http://www.tangazenileo.com/blog/2013/03/16/gnome-3-extension-development-hints-6-extension-preferences/ Good example of creating extension prefs]
Line 22: Line 26:
 
== Installing on Ubuntu 12 ==
 
== Installing on Ubuntu 12 ==
 
They've now made Unity the default desktop environment which many people find really horrible, to install GNOME do the following:
 
They've now made Unity the default desktop environment which many people find really horrible, to install GNOME do the following:
{{code|<bash>sudo add-apt-repository ppa:gnome3-team/gnome3
+
<source lang="bash">
 +
sudo add-apt-repository ppa:gnome3-team/gnome3
 
sudo apt-get update
 
sudo apt-get update
sudo apt-get install gnome-shell</bash>}}
+
sudo apt-get install gnome-shell
 +
</source>
 
Then log out and select GNOME at the login prompt
 
Then log out and select GNOME at the login prompt
  
Line 31: Line 37:
 
== Adding your own apps to the search ==
 
== Adding your own apps to the search ==
 
You'll need to create a ''.desktop'' file for your application in the '''~/.local/share/applications''' directory with the name of your application as its filename. The content of the file is of the following format:
 
You'll need to create a ''.desktop'' file for your application in the '''~/.local/share/applications''' directory with the name of your application as its filename. The content of the file is of the following format:
{{code|<pre>
+
<source>
 
[Desktop Entry]
 
[Desktop Entry]
 
Name=My applications name
 
Name=My applications name
Line 40: Line 46:
 
Type=Application
 
Type=Application
 
StartupNotify=true
 
StartupNotify=true
</pre>}}
+
</source>
  
 
== Where'd the startup applications applet go? ==
 
== Where'd the startup applications applet go? ==

Latest revision as of 22:14, 8 September 2022

Legacy.svg Legacy: This article describes a concept that has been superseded in the course of ongoing development on the Organic Design wiki. Please do not develop this any further or base work on this concept, this is only useful for a historic record of work done. You may find a link to the currently used concept or function in this article, if not you can contact the author to find out what has taken the place of this legacy item.


GNOME offers an easy to understand desktop environment for your GNU/Linux or UNIX computer.

GNOME 3

GNOME3 Screenshot.png

Extensions

The GNOME Shell extension design is designed to give a high degree of power to the parts of the GNOME interface managed by the shell, such as window management and application launching. It simply loads arbitrary JavaScript and CSS. This gives developers a way to make many kinds of changes and share those changes with others, without having to patch the original source code and recompile it, and somehow distribute the patched code.

Extensions are listed at extensions.gnome.org and can be installed one-click style directly from the site :-) some extensions that I recommend are:

Writing extensions

Create an initial working extension template using the gnome-shell-extension-tool --create-extension command, then after you change your code, you restart the Gnome shell by pressing ALT+F2, then entering r and pressing Enter. To check for errors and perform other debugging tasks, use the LookingGlass applet which can be started by pressing ALT+F2, then entering lg and pressing Enter, and escape to close it. Use the command global.log("text") in your code to output to the error console which you can view from LookingGlass in the errors tab - not that it doesn't update in real-time.

Installing on Ubuntu 12

They've now made Unity the default desktop environment which many people find really horrible, to install GNOME do the following:

sudo add-apt-repository ppa:gnome3-team/gnome3
sudo apt-get update
sudo apt-get install gnome-shell

Then log out and select GNOME at the login prompt

Login-select-Gnome-Shell.png

Adding your own apps to the search

You'll need to create a .desktop file for your application in the ~/.local/share/applications directory with the name of your application as its filename. The content of the file is of the following format:

[Desktop Entry]
Name=My applications name
Comment=My cool application
Exec=/full/path/to/my/app
Icon=/full/path/to/my/app/icon
Terminal=false
Type=Application
StartupNotify=true

Where'd the startup applications applet go?

It's still the same program which is gnome-session-properties, but for some reason there's no longer a launcher for it - you can make one using the instructions in the previous section if you like, or launch it manually from a terminal window.

See also