Skip to content

Windows (New)

Jump to bottom Edit New page
pepeleproso edited this page Oct 14, 2012 · 21 revisions

Note

This guide is still a work in progress, so it is recommended that to read rough guide to create windows packages on the blog as well.

Introduction

In this guide you will learn how to both run emesene2 from source and how to package it. It is meant to help both testers and developers who are using Windows as their OS of choice. For those that would like to just try out new features and bugfixes, there are pre-packaged development/experimental packages available at https://github.com/emesene/emesene/downloads.

Requirements

Recommended

  • 7-Zip (For uncompressing .7z files)
  • Notepad++ (Great program for coding in multiple languages)

Required

Installation

Install

  1. Install Python, use the default options so just kept clicking next.
  2. Install PyGTK all-in-one, use the default options so just kept clicking next.
  3. Install Visual C++ 2008 Redistributable Package, use the default options so just kept clicking next.
  4. Install Win32 OpenSSL, use the default options so just kept clicking next.
  5. Install PyOpenSSL, use the default options so just kept clicking next.
  6. Unzip and install PyCrypto, use the default options so just kept clicking next.
  7. Install PyWin32, use the default options so just kept clicking next.
  8. Extract WebKitGTK+ to C:\Python26\Lib\site-packages\gtk-2.0\runtime\, and select No for any file override.
  9. Extract PyWebKitGtk to C:\Python26\.
  10. Extract dnspython to C:\Python26\Lib\site-packages\.
  11. Install py2exe, use the default options so just kept clicking next.
  12. Install NSIS, use the default options so just kept clicking next.
  13. Install MSysGit, use the default options so just kept clicking next.

Setting Up Python

Windows XP:

  1. Right click on My Computer.
  2. Click on Properties.
  3. Go to the Advanced tab.
  4. Click on the Environment Variables button.
  5. In the System variables section, select Path, and click Edit.
  6. In the Variable value textbox, at the end add ;C:\Python26.
  7. Click OK to save changes.

Windows Vista?/7:

  1. Right click on Computer in the startmenu.
  2. Click on Properties.
  3. Click on Advanced system settings.
  4. Click on the Environment Variables button.
  5. In the System variables section, select Path, and click Edit.
  6. In the Variable value textbox, at the end add ;C:\Python26.
  7. Click OK to save changes.

Running from source

  1. git clone https://github.com/emesene/emesene.git clone the repo locally
  2. cd emesene move inside the repo folder
  3. git reset --hard v2.yy.x Only if you wan't to reset your code (you will lost any change you have made)
  4. git pull If you wan't latest changes (ie, you have some custom change that you want to keep and also get latest changes)
  5. cd emesene move inside emesene's folder
  6. python emesene.py run emesene

Generating windows executable code

  1. Exit the emesene window that popped up after running from source. Leave the terminal open.
  2. Go back to the base dir cd ..
  3. cp ./windows/boot_common.py /c/Python26/Lib/site-packages/py2exe/ assuming your python's installation is on c:/Python26, this prevents an ugly error popup when closing emesene
  4. python setup.py py2exe You should always download LATEST setup.py version, no matter what emesene version you are building, setup.py was broken between 2.11.7 and 2.11.11 (inclusive)

This will create a folder called dist, inside you have 4 exes: emesene.exe (without console output visible, everything goes to emesene.exe.log) emesene_debug.exe (with console output) emesene_portable.exe (will create an emesene folder inside the working directory to store config, every log is saved inside emesene_portable.exe.log) emesene_portable_debug.exe (with console output and portable config)

setup.py file assumes you have "/c/Python26/Lib/site-packages/gtk-2.0/" added to your system path variable (it should be if you followed above steps to run emesene from source), it will copy some content from /runtime/lib, /runtime/share and /runtime/etc to have a better look and working Adium Themes.

it will also add Clearlooks as the default theme, you can install any other theme if you want to, just do it before packaging everything with nsis

Package installer and portable versions:

  1. NOTE: If you have run emesene from the dist folder (using the generated exes), remember to remove any extra file like .exe.log files and emesene config folder if you used the portable exe, or NSIS will add those to the final package.
  2. In the emesene folder in your directory, right click on the .nsi files with "MUI" in the name.
  3. Select Compile NSIS Script and wait for NSIS to package emesene into an installer/portable version.

For Developers

(W.I.P.) If you want to submit changes to the code, this is for you.

Setting Up Git

  1. Set up SSH keys.
  2. Set up your info.

Check out the Window's Set Up Git guide to learn how. Includes pictures.

Experimental Gtk3 windows suppport

Note: this is experimental so expect failures. Actually there's no webkit support.

KNOW BUG: on XP emesene crash when you move a window on Windows 7 emesene freeze instead.

Recommended

  • 7-Zip (For uncompressing .7z files)
  • Notepad++ (Great program for coding in multiple languages)

Required

Installation

  • Follow the same instruccion as the gtk2 version for the common packages, but use C:\Python27\ instead of C:\Python26\
  • Download bundle from here http://optionexplicit.be/projects/gnome-windows/GTK+3/gtk+/git/
  • Copy the bundle file into c:/emesene/bundle and copy installergtk3.py too
  • run installergtk3.py
  • Run emesene from source
  • if you want to make an installer then run setupgtk3.py and the nsis script

KNOW BUG: popup menu on tray icon don't work KNOW BUG: backcolor on notifications is not working well KNOW BUG: sliders have problems **KNOW BUG: crash when move windows. Need to remove gtk.gdk.threads_init(), gtk.gdk.threads_enter() y gtk.gdk.threads_leave() calls **

Add a custom footer
Add a custom sidebar

Clone this wiki locally