<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="plugin-python-console">

  <info>
   <link type="guide" xref="index#advanced"/>
   <desc>The Python console can be used to add extra functions and run scripts in the image viewer.</desc>

   <revision pkgversion="3.24" version="0.1" date="2011-09-05" status="final"/>
   <credit type="author">
     <name>Tiffany Antopolski</name>
     <email>tiffany.antopolski@gmail.com</email>
   </credit>
   <license>
     <p>Creative Commons Share Alike 3.0</p>
   </license>

  </info>

<title>Python console</title>

<p>The image viewer has a plugin system which uses the Python scripting 
 language. If you activate the <em>Python console</em>, you can gain direct 
 access to a Python interpreter from inside the image viewer, which you can 
 then use to write scripts or programmatically manipulate images, for example.</p>

<steps>
 <item>
  <p>In order to enable this feature, you need to have installed <link
  xref="plugins">eog-plugins</link>.</p>
 </item>
 <item>
  <p>Once <sys>eog-plugins</sys> is installed, open the application menu on the
  top bar, click <gui style="menuitem">Preferences</gui>, and go to the
  <gui>Plugins</gui> tab.</p>
 </item>
 <item>
  <p>Check <gui>Python Console</gui> and click <gui>Close</gui>.</p>
 </item>
 <item>
  <p>Click the <gui style="menuitem">Python Console</gui> menu item to 
  bring up the console.</p>
 </item>
</steps>

</page>
