Recent changes to Installation_Instructions

Installation_Instructions modified by nanotube

nanotube — Sat, 06 Sep 2014 14:47:20 -0000

--- v8
+++ v9
@@ -14,72 +14,19 @@

 If you want to run PyKeylogger from source, it requires the following dependencies: 

-Library  Library Description  Library Version  OS  PyKeylogger Version  Comments 
+Library | Library Description | Library Version | OS | PyKeylogger Version | Comments 
+---     | ----                | ----            |----|-------------------  | -------
+[Python](http://www.python.org) | The python language interpreter | 2.4.x | All | 0.8.0 
+[Python](http://www.python.org) | The python language interpreter | >= 2.4.x | All | >= 0.8.1 | Use the official python distribution from python.org, to minimize potential problems. 
+[Python Imaging Library (PIL)](http://www.pythonware.com/products/pil/) | Image processing, used for image capture functionality. | >=1.1.6 | All | >=1.0.0 | Earlier versions may work, but no guarantees. 
+[ConfigObj](http://www.voidspace.org.uk/python/configobj.html) | Flexible .ini file parsing | >=4.5.2 | All | >= 0.8.0 | Get archive with both configobj.py and validate.py. To install ConfigObj: Unzip the contents of the archive
Open a command prompt and 'cd' to the directory where you unzipped
Run "python setup.py install"
+[pyHook](http://pyhook.sourceforge.net) | Wraps the Windows API to capture mouse and keyboard events. | 1.5.1 | Windows | All 
+[py2exe](http://www.py2exe.org/) | Builds windows executable out of python source. | 0.6.8 (Use 0.6.6 if you use pyHook version earlier than 1.5.1) | Windows | >= 0.8.0 | Optional, use only if you want to freeze your own executable out of source. 
+[PyWin32](http://sourceforge.net/projects/pywin32/) | Provide access to the Windows API. | >= 212 | Windows | All | Previously known as "win32all extensions" 
+[python-xlib](http://python-xlib.sourceforge.net/) | Interfaces with the X server API, used to capture mouse and keyboard events. | >= 0.14 | Linux | >= 1.0.0 |
+[pygtk](http://www.pygtk.org/) | Python GTK binding, used to quickly capture full-screen screenshots. | | Linux | >= 1.2.0 | Usually included in the default install. 

-[Python](http://www.python.org)
-The python language interpreter 
-2.4.x 
-All 
-0.8.0 
-
-[Python](http://www.python.org)
-The python language interpreter 
->= 2.4.x 
-All 
->= 0.8.1 
-Use the official python distribution from python.org, to minimize potential problems. 
-
-[Python Imaging Library (PIL)](http://www.pythonware.com/products/pil/)
-Image processing, used for image capture functionality. 
->=1.1.6 
-All 
->=1.0.0 
-Earlier versions may work, but no guarantees. 
-
-[ConfigObj](http://www.voidspace.org.uk/python/configobj.html)
-Flexible .ini file parsing 
->=4.5.2 
-All 
->= 0.8.0 
-Get archive with both configobj.py and validate.py. To install ConfigObj: 
-
-  * Unzip the contents of the archive 
-  * Open a command prompt and 'cd' to the directory where you unzipped 
-  * Run "python setup.py install" 
-
-[pyHook](http://pyhook.sourceforge.net)
-Wraps the Windows API to capture mouse and keyboard events. 
-1.5.1 
-Windows 
-All 
-
-[py2exe](http://www.py2exe.org/)
-Builds windows executable out of python source. 
-0.6.8 (Use 0.6.6 if you use pyHook version earlier than 1.5.1) 
-Windows 
->= 0.8.0 
-Optional, use only if you want to freeze your own executable out of source. 
-
-[PyWin32](http://sourceforge.net/projects/pywin32/)
-Provide access to the Windows API. 
->= 212 
-Windows 
-All 
-Previously known as "win32all extensions" 
-
-[python-xlib](http://python-xlib.sourceforge.net/)
-Interfaces with the X server API, used to capture mouse and keyboard events. 
->= 0.14 
-Linux 
->= 1.0.0 
-
-[pygtk](http://www.pygtk.org/)
-Python GTK binding, used to quickly capture full-screen screenshots. 
-Linux 
->= 1.2.0 
-Usually included in the default install. 
-
-After all these dependencies are installed, download and unzip the PyKeylogger source zip archive, double click the keylogger.pyw file (or run "python keylogger.pyw" from a terminal), and it will run in the background, logging your keys. 
+After all the needed dependencies are installed, download and unzip the PyKeylogger source zip archive, double click the keylogger.pyw file (or run "python keylogger.pyw" from a terminal), and it will run in the background, logging your keys. 

 ## Some Linux notes

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:13 -0000

--- v7
+++ v8
@@ -85,7 +85,7 @@

   * You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named _python-configobj_, _python-xlib_, _python-imaging_, _python-gtk2_, and of course, _python_. Just make sure you have the right versions of these in your repos - which you would, if you're running a relatively recent distro. 
   * You may also have to enable the 'record' extension on your X server (if it's not enabled by default). To do that, edit your _/etc/X11/xorg.conf_, and in _Section "Module"_ add the line **Load "record"**. Restart X for changes to take effect. 
-  * Note that Xorg > 1.5 has a broken record module... Hopefully will be fixed soon, but for now refer to [these](http://sourceforge.net/forum/forum.php?thread_id=3363363&forum_id=493189) [links](http://sourceforge.net/tracker/?func=detail&aid=2792089&group_id=147501&atid=768629) [for](http://bugs.freedesktop.org/show_bug.cgi?id=20500) more info. 
+  * Note that Xorg > 1.5 has a broken record module... Hopefully will be fixed soon, but for now refer to [these](http://sourceforge.net/forum/forum.php?thread_id=3363363&forum_id=493189) [links](http://sourceforge.net/tracker/?func=detail&aid=2792089&group_id=147501&atid=768629) [for](http://bugs.freedesktop.org/show_bug.cgi?id=20500) more info. It seems that it is fixed as of the Xorg that ships with Ubuntu Lucid. 

 ## Create Windows executables

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:13 -0000

--- v6
+++ v7
@@ -94,7 +94,7 @@
     python setup.py py2exe

-_Note: if you haven't included python in your PATH, you will have to specify the full path to the python executable._ This will create a subdirectory named "dist" with the binaries and all supporting libraries. 
+(Note: if you haven't included the python install directory in your PATH, you will have to specify the full path to the python executable in your command. Instead of just 'python', it will be something like _C:\Python26\python.exe_.) This will create a subdirectory named "dist" with the binaries and all supporting libraries. 

 To create your own installer, you have to get [NSIS (Nullsoft Scriptable Install System](http://nsis.sourceforge.net/), then use it to build the installer from the "pykeylogger_install_script.nsi" file that comes with the source distribution of PyKeylogger. Note that the .nsi looks for the built binaries in "./pykeylogger-[version]" directory, so you have to rename the "dist" subdirectory that was created by py2exe so that NSIS can find it.

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:12 -0000

--- v5
+++ v6
@@ -89,13 +89,12 @@

 ## Create Windows executables

-To create your own executables (Windows only), run 
+To create your own Windows executables, open a terminal (command prompt), _cd_ to the directory where you have extracted the PyKeylogger source, and run 

     python setup.py py2exe

-    

-from a terminal. This will create subdirectory named "dist" with the binaries and all supporting libraries. 
+_Note: if you haven't included python in your PATH, you will have to specify the full path to the python executable._ This will create a subdirectory named "dist" with the binaries and all supporting libraries. 

 To create your own installer, you have to get [NSIS (Nullsoft Scriptable Install System](http://nsis.sourceforge.net/), then use it to build the installer from the "pykeylogger_install_script.nsi" file that comes with the source distribution of PyKeylogger. Note that the .nsi looks for the built binaries in "./pykeylogger-[version]" directory, so you have to rename the "dist" subdirectory that was created by py2exe so that NSIS can find it.

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:12 -0000

--- v4
+++ v5
@@ -27,6 +27,7 @@
 >= 2.4.x 
 All 
 >= 0.8.1 
+Use the official python distribution from python.org, to minimize potential problems.

 [Python Imaging Library (PIL)](http://www.pythonware.com/products/pil/)
 Image processing, used for image capture functionality.

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:12 -0000

--- v3
+++ v4
@@ -14,37 +14,77 @@

 If you want to run PyKeylogger from source, it requires the following dependencies: 

-## Common libraries
+Library  Library Description  Library Version  OS  PyKeylogger Version  Comments 

-  * [Python](http://www.python.org)
-    * PyKeylogger v. 0.8.0 and earlier: use python 2.4.x 
-    * PyKeylogger v. 0.8.1 and later: can use both python 2.4.x and 2.5.x 
-  * [Python Imaging Library (PIL)](http://www.pythonware.com/products/pil/) For PyKeylogger 1.0.0 and up, for image capture functionality. 
-    * Recommended version: 1.1.6. (Earlier versions may work, but no guarantees.) 
-  * [ConfigObj](http://www.voidspace.org.uk/python/configobj.html)
-    * Recommended version: 4.5.2 and up. [Do not use versions between 4.3.2 and 4.5.2, they have a bug that breaks PyKeylogger] 
-    * Get archive with both configobj.py and validate.py. To install ConfigObj: 
-      * Unzip the contents of the archive 
-      * Open a command prompt and 'cd' to the directory where you unzipped 
-      * Run "python setup.py install" 
+[Python](http://www.python.org)
+The python language interpreter 
+2.4.x 
+All 
+0.8.0 

-## Windows Libraries
+[Python](http://www.python.org)
+The python language interpreter 
+>= 2.4.x 
+All 
+>= 0.8.1 

-  * [pyHook](http://pyhook.sourceforge.net) This is the library that interfaces with Windows API to capture mouse and keyboard events. 
-    * Recommended version: 1.5.1 
-  * [py2exe](http://www.py2exe.org/) [Optional: only if you want to freeze your own executable out of source.] 
-    * Recommended version: 0.6.8 [Use 0.6.6 if you use pyHook version earlier than 1.5.1] 
-  * [PyWin32 (formerly known as win32all extensions)](http://sourceforge.net/projects/pywin32/)
+[Python Imaging Library (PIL)](http://www.pythonware.com/products/pil/)
+Image processing, used for image capture functionality. 
+>=1.1.6 
+All 
+>=1.0.0 
+Earlier versions may work, but no guarantees. 

-## Linux Libraries
+[ConfigObj](http://www.voidspace.org.uk/python/configobj.html)
+Flexible .ini file parsing 
+>=4.5.2 
+All 
+>= 0.8.0 
+Get archive with both configobj.py and validate.py. To install ConfigObj: 

-  * [python-xlib](http://python-xlib.sourceforge.net/) This is the library that interfaces with the X server API to capture mouse and keyboard events. 
-    * Recommended version: 0.14 or later. Earlier versions do not have the record module and won't work. 
-  * [pygtk](http://www.pygtk.org/) is used to capture full-screen screenshots. This of course also requires the GTK library itself. 
-  * You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named _python-configobj_, _python-xlib_, _python-imaging_, _python-gtk2_, and of course, _python_. Just make sure you have the right versions of these in your repos. 
-  * You may also have to enable the 'record' extension on your X server (if it's not enabled by default). To do that, edit your _/etc/X11/xorg.conf_, and in _Section "Module"_ add the line **Load "record"**. Restart X for changes to take effect. 
+  * Unzip the contents of the archive 
+  * Open a command prompt and 'cd' to the directory where you unzipped 
+  * Run "python setup.py install" 
+
+[pyHook](http://pyhook.sourceforge.net)
+Wraps the Windows API to capture mouse and keyboard events. 
+1.5.1 
+Windows 
+All 
+
+[py2exe](http://www.py2exe.org/)
+Builds windows executable out of python source. 
+0.6.8 (Use 0.6.6 if you use pyHook version earlier than 1.5.1) 
+Windows 
+>= 0.8.0 
+Optional, use only if you want to freeze your own executable out of source. 
+
+[PyWin32](http://sourceforge.net/projects/pywin32/)
+Provide access to the Windows API. 
+>= 212 
+Windows 
+All 
+Previously known as "win32all extensions" 
+
+[python-xlib](http://python-xlib.sourceforge.net/)
+Interfaces with the X server API, used to capture mouse and keyboard events. 
+>= 0.14 
+Linux 
+>= 1.0.0 
+
+[pygtk](http://www.pygtk.org/)
+Python GTK binding, used to quickly capture full-screen screenshots. 
+Linux 
+>= 1.2.0 
+Usually included in the default install. 

 After all these dependencies are installed, download and unzip the PyKeylogger source zip archive, double click the keylogger.pyw file (or run "python keylogger.pyw" from a terminal), and it will run in the background, logging your keys. 
+
+## Some Linux notes
+
+  * You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named _python-configobj_, _python-xlib_, _python-imaging_, _python-gtk2_, and of course, _python_. Just make sure you have the right versions of these in your repos - which you would, if you're running a relatively recent distro. 
+  * You may also have to enable the 'record' extension on your X server (if it's not enabled by default). To do that, edit your _/etc/X11/xorg.conf_, and in _Section "Module"_ add the line **Load "record"**. Restart X for changes to take effect. 
+  * Note that Xorg > 1.5 has a broken record module... Hopefully will be fixed soon, but for now refer to [these](http://sourceforge.net/forum/forum.php?thread_id=3363363&forum_id=493189) [links](http://sourceforge.net/tracker/?func=detail&aid=2792089&group_id=147501&atid=768629) [for](http://bugs.freedesktop.org/show_bug.cgi?id=20500) more info. 

 ## Create Windows executables

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:12 -0000

--- v2
+++ v3
@@ -40,7 +40,8 @@

   * [python-xlib](http://python-xlib.sourceforge.net/) This is the library that interfaces with the X server API to capture mouse and keyboard events. 
     * Recommended version: 0.14 or later. Earlier versions do not have the record module and won't work. 
-  * You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named _python-configobj_, _python-xlib_, _python-imaging_, and of course, _python_. Just make sure you have the right versions of these in your repos. 
+  * [pygtk](http://www.pygtk.org/) is used to capture full-screen screenshots. This of course also requires the GTK library itself. 
+  * You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named _python-configobj_, _python-xlib_, _python-imaging_, _python-gtk2_, and of course, _python_. Just make sure you have the right versions of these in your repos. 
   * You may also have to enable the 'record' extension on your X server (if it's not enabled by default). To do that, edit your _/etc/X11/xorg.conf_, and in _Section "Module"_ add the line **Load "record"**. Restart X for changes to take effect. 

 After all these dependencies are installed, download and unzip the PyKeylogger source zip archive, double click the keylogger.pyw file (or run "python keylogger.pyw" from a terminal), and it will run in the background, logging your keys.

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:12 -0000

--- v1
+++ v2
@@ -41,7 +41,7 @@
   * [python-xlib](http://python-xlib.sourceforge.net/) This is the library that interfaces with the X server API to capture mouse and keyboard events. 
     * Recommended version: 0.14 or later. Earlier versions do not have the record module and won't work. 
   * You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named _python-configobj_, _python-xlib_, _python-imaging_, and of course, _python_. Just make sure you have the right versions of these in your repos. 
-  * You must also enable the 'record' extension on your X server. To do that, edit your _/etc/X11/xorg.conf_, and in _Section "Module"_ add the line **Load "record"**. Restart X for changes to take effect. 
+  * You may also have to enable the 'record' extension on your X server (if it's not enabled by default). To do that, edit your _/etc/X11/xorg.conf_, and in _Section "Module"_ add the line **Load "record"**. Restart X for changes to take effect.

 After all these dependencies are installed, download and unzip the PyKeylogger source zip archive, double click the keylogger.pyw file (or run "python keylogger.pyw" from a terminal), and it will run in the background, logging your keys.

Installation_Instructions modified by nanotube

nanotube — Fri, 20 Jun 2014 18:22:12 -0000

Running the Binary (Windows-only)
Running from Source
More Help

Running the Binary (Windows-only)

The simplest way to use PyKeylogger on Windows is to use the binary distribution.

Get the binary package (instructions).
If you got the executable installer, just run it and it will install PyKeylogger to wherever you specify.
If you got the zip archive, unzip the archive, and put the contents anywhere you want (as long as they are all together in the same directory, of course)
To start logging keys, just run pykeylogger.exe (if you used the installer, you can start it from the start menu shortcut). You can rename the exe to anything you want before running it, if you don't want "pykeylogger.exe" showing up in your task list.
Default log location is the directory "logs" within the pykeylogger directory. Default master password is blank. To customize this, and other defaults, use the control panel. (For more detail, see [Usage_Instructions].)

Running from Source

If you want to run PyKeylogger from source, it requires the following dependencies:

Common libraries

Python
- PyKeylogger v. 0.8.0 and earlier: use python 2.4.x
- PyKeylogger v. 0.8.1 and later: can use both python 2.4.x and 2.5.x
Python Imaging Library (PIL) For PyKeylogger 1.0.0 and up, for image capture functionality.
- Recommended version: 1.1.6. (Earlier versions may work, but no guarantees.)
ConfigObj
- Recommended version: 4.5.2 and up. [Do not use versions between 4.3.2 and 4.5.2, they have a bug that breaks PyKeylogger]
- Get archive with both configobj.py and validate.py. To install ConfigObj:
- Unzip the contents of the archive
- Open a command prompt and 'cd' to the directory where you unzipped
- Run "python setup.py install"

Windows Libraries

pyHook This is the library that interfaces with Windows API to capture mouse and keyboard events.
- Recommended version: 1.5.1
py2exe [Optional: only if you want to freeze your own executable out of source.]
- Recommended version: 0.6.8 [Use 0.6.6 if you use pyHook version earlier than 1.5.1]
PyWin32 (formerly known as win32all extensions)

Linux Libraries

python-xlib This is the library that interfaces with the X server API to capture mouse and keyboard events.
- Recommended version: 0.14 or later. Earlier versions do not have the record module and won't work.
You may be able to find a lot of these libraries in the repositories for your distro. Look for packages named python-configobj, python-xlib, python-imaging, and of course, python. Just make sure you have the right versions of these in your repos.
You must also enable the 'record' extension on your X server. To do that, edit your /etc/X11/xorg.conf, and in Section "Module" add the line Load "record". Restart X for changes to take effect.

After all these dependencies are installed, download and unzip the PyKeylogger source zip archive, double click the keylogger.pyw file (or run "python keylogger.pyw" from a terminal), and it will run in the background, logging your keys.

Create Windows executables

To create your own executables (Windows only), run

python setup.py py2exe

from a terminal. This will create subdirectory named "dist" with the binaries and all supporting libraries.

To create your own installer, you have to get NSIS (Nullsoft Scriptable Install System, then use it to build the installer from the "pykeylogger_install_script.nsi" file that comes with the source distribution of PyKeylogger. Note that the .nsi looks for the built binaries in "./pykeylogger-[version]" directory, so you have to rename the "dist" subdirectory that was created by py2exe so that NSIS can find it.

Default log location is the directory "logs" within the pykeylogger directory. Default master password is blank. To customize this, and other defaults, use the control panel. (For more detail, see Usage Instructions.)

Recent changes to Installation_Instructions

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Installation_Instructions modified by nanotube

Running the Binary (Windows-only)

Running from Source

Common libraries

Windows Libraries

Linux Libraries

Create Windows executables

More Help