<?xml version="1.0" encoding="utf-8"?>
<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="plugin-python-console" xml:lang="eog-en-GB">

  <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"/>
   <revision pkgversion="3.31.90" version="0.2" date="2019-03-03" 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>

  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>David Lodge</mal:name>
      <mal:email>dave@cirt.net</mal:email>
      <mal:years>2017</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Zander Brown</mal:name>
      <mal:email>zbrown@gnome.org</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  
    <mal:credit xmlns:mal="http://projectmallard.org/1.0/" type="translator copyright">
      <mal:name>Bruce Cowan</mal:name>
      <mal:email>bruce@bcowan.me.uk</mal:email>
      <mal:years>2020</mal:years>
    </mal:credit>
  </info>

<title>Python console</title>

<p>The image viewer has a plug-in 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, press the menu button in the top-right corner of the window, select <gui style="menuitem">Preferences</gui>, and go to the <gui>Plug-ins</gui> tab.</p>
 </item>
 <item>
  <p>Check <gui>Python Console</gui> and close the dialog.</p>
 </item>
 <item>
  <p>Click the <gui style="menuitem">Python Console</gui> menu item to bring up the console.</p>
 </item>
</steps>

</page>
