Wednesday, March 30, 2011
call for translators!
https://translations.launchpad.net/emesene/trunk/+translations
of course some devs, packagers and testers are needed too* :)
* in that order ;)
Thursday, March 17, 2011
rough guide to create windows packages
with this and using my repo you should have a fully working version (with some bugs, but those are from emesene and note because of the packaging)
download the following files and install them in the order they appear
- python 2.6
- pygtk all in one
- vc++ 2008 redistributable
- openssl 1.0
- pyopenssl
- pycrypto
- pywin32
download the following two and follow the instructions below
- webkit
- pywebkit
- download and install 7 zip
- extract the webkit file on:
- C:\Python26\Lib\site-packages\gtk-2.0\runtime\
- if it asks for an override select "No"
- extract the pywebkit file on:
- C:\Python26\
install the following files
- py2exe
- nsis
- msysgit
open the git shell and do
git clone https://github.com/emesene/emesene.git cd emesene git submodule init git submodule update cd emesene cp ../dlls/* . cp -r e3/papylib/papyon/papyon/ .
cp -r e3/jabber/xmppy/xmpp/ .
set the python path (rigth click on "My Computer", click on properties, go to
the advanced tab, click the "Environment Variables" button, on the "System
variables" section select the "Path" variable and click edit, on the "Variable
value" dield go to the end and add ";C:\Python26" without the quotes and click
ok to close all the dialogs. Open a new shell and go to the directory where you
where before and do
python emesene.py
creating the installer
first you need to override the boot_common.py file from py2exe to avoid displaying an annoying dialog at exit.
to do this you have to copy the file in windows/boot_common.py on the emesene repository to the py2exe directory, in my case in the command line (using the git command line that has come cool unix tools) is:
you only need to do this once.
cp ../windows/boot_common.py /c/Python26/Lib/site-packages/py2exe/
and then
cp ../setup.py ../ez_setup.py ../emesene.ico . python setup.py py2exe cp *.dll ../dist/ cd ../dist/
copy "etc" "lib" and "share" from C:\Python26\Lib\site-packages\gtk-2.0\runtime
to emesene/dist
on the git shell it would be
cp -r /c/Python26/Lib/site-packages/gtk-2.0/runtime/etc/ . cp -r /c/Python26/Lib/site-packages/gtk-2.0/runtime/lib/ . cp -r /c/Python26/Lib/site-packages/gtk-2.0/runtime/share/ .
then remove some unused files to make the installers smaller
cd share/ rm -rf aclocal/ dtds/ doc/ icon-naming-utils/ locale/* gtk-doc icons/Tango/scalable/ cd themes/ rm -rf Default/ Emacs/ Raleigh/ cd ../..
you can still remove more files (like unused icons)
now right click on the .nsi files on emesene/ and select "Compile NSIS Script"
they will create the installer and the protable versions for you
and that's all
Wednesday, March 16, 2011
pygtk all in one installer for windows, someone wants to give it a try?
https://github.com/dieterv/pygtk-installer
instructions to setup git and github on windows
http://help.github.com/win-set-up-git/
enjoy!
Thursday, March 10, 2011
where to start to help with development
this is a small guide for people that want to start helping us in emesene 2.
the idea of this guide is to start with small tasks until you feel confident with the code base.
first read the description of the project here:
http://emesene.org/docs/
then read PEP8, the python coding style guide we follow: http://www.python.org/dev/peps/pep-0008/
then install pylint on your computer and all the tools needed to code (a text editor, git etc.)
the configure your editor to replace tabs to 4 spaces, this is important.
then you can do two things:
- go to the issue tracker and look for an easy ticket, and try to fix it
- start running pylint on modules and fixing the warnings and error that appears*
when you start developing you should create a github account, fork emesene/emesene from here https://github.com/emesene/emesene make the changes and make a pull request.
if you want to be ordered you could create a branch for each improvement, do a pull request of that branch and when accepted, merge the branch to master.
this is not needed but if you want to improve your git skills this workflow can help you
I hope this helps, if you have any doubt post a comment, I will update this post if some questions are useful for all.
* pylint reports some errors that are not in fact errors, you will learn to recognize them after some time.
Wednesday, March 09, 2011
emesene organization
I created 4 new repositories in emesene organization at github, those repositories are:
- emesene supported plugins
- emesene community plugins
- emesene supported themes
- emesene community themes
you can see them here: https://github.com/emesene
the idea is to separate the repositories that contain plugins and themes from the main emesene repo so changes in that repo are only code related and related to emesene.
this also gives a place where plugin and theme developers can join and discuss things using git's wiki and issue tracker.
the idea is to have a a set of really useful and well maintained plugins and themes in the supported repos but also have a more "liberal" repository where new themes and plugins can be submitted and people can discuss around them.
I will be moving the themes and plugins from emesene to the correspondent repos in the following days.
come over and help us!
Friday, March 04, 2011
status update
just a post to inform some updates:
- emesene 2 developments continues, slower than we would like to since we are lacking developers (help us!)
- emesene 2 was accepted in the next releases of debian (sid) and ubuntu (11.04) those are awesome news, but we need to speed up development so we have the best client when those distributions release
- we are talking with "cloud" (our benevolent dictator for some time* TM) on consolidating all the sites and interaction around this blog and github (you can see a teaser now)
- I started doing small changes to make emesene 2 as forward compatible with python 3 as we can to ease the migration when the time comes
* "some time" is defined by cloud
Wednesday, January 19, 2011
developers of the month
but not completely quiet thanks to some new developers that are starting to code for emesene 2 and helping us improve it.
thanks to Andrea Stagi, j0hn and sbte for their help!
this shows that people can start helping with small improvements and move to more complex ones once they get used to the code.
what are you waiting?
Thursday, December 30, 2010
an idea
one step further:
document the design and make it generic for any IM client so people can store all their chat logs in the same database.
know some python and SQL and want to help?
build a script that imports the logs from emesene 1 SQLite schema to the schema in emesene 2 SQLite log format.
this would be really helpful and may help some people to migrate to emesene 2.
Wednesday, December 08, 2010
updated instructions for windows users (still no package)
the new stuff is related to the papyon backend for msn that now is the only supported backend and has some dependencies (OpenSSL, pyCrypto) and those need to be installed.
to make both instructions similar I recommend that you download and install msysgit from here:
http://code.google.com/p/msysgit/
and follow the instructions from here:
http://emesene-msn.blogspot.com/2010/10/instructions-for-testers.html
until you downloaded emesene code and updated the submodules, then follow the instructions in the INSTALL_WINDOWS.txt file here is an updated version:
https://github.com/marianoguerra/emesene/blob/master/INSTALL_WINDOWS.txt
I got emesene to run using papyon with this setup but the portable version gave me protocol error, if you can find the way to fix it it would be great.
still waiting for packages...
EDIT: I forgot to add one instruction, before running python setup.py py2exe you need to copy the papyon folder that is in emesene/emesene/e3/papylib/papyon/papyon to emesene/emesene/papyon, something like:
cp -r emesene/emesene/e3/papylib/papyon/papyon emesene/emesene/
to avoid the import error trying to load papyon.
Saturday, November 20, 2010
friendly reminder
- we need developers! (we really do, please help us!)
- we need testers (better if they try to help us to fix the problems they find :)
- we need packagers! (windows packagers are the most important right now)
- report bugs here: https://github.com/emesene/emesene/issues
- docs here: http://emesene.org/docs/ (ask for more documentation on a topic if you need it)
- spread the word about this post!
Wednesday, November 03, 2010
call for windows users
you want to collaborate? have windows installed and want to play a little with emesene 2?
then help us!
we need to bundle pywebkitgtk on windows to use adium themes in the conversation window.
I tried to make it work today but I couldn't, if you want to play and try to make it work, if you do document the steps so we can update the installer guide.
we will give you some rounds of applause for making something really useful for the project.
this site http://opensourcepack.blogspot.com/2009/12/pywebkitgtk-windows-binary.html seems to have the libraries needed, I downloaded the files and could run a demo browser that comes with it, but I couldn't make import webkit work, I got a dll loading error.
happy hacking!
Friday, October 29, 2010
Windows users, your turn
you asked for it, now you have it, make windows a first class citizen for emesene 2.
test it, fix the problems and provide up to date versions of emesene for your platform.
linux, *BSD users: what are you waiting to document how to package for your distro of choice and be at the level of windows?
if you have the steps documented, contact me so we can add them to the emesene repo and keep the updated versions where users can see them.
happy packaging!
Como generar archivos .exe e instaladores para una aplicación python (y pygtk)
Como generar archivos .exe e instaladores para una aplicación python
Este documento describe los pasos necesarios para crear un archivo ejecutable
de una aplicación python y como generar un instalador y una versión portable
para dicha instalación.
Este documento asume que la aplicación se basa en GTK pero debería funcionar
con menores cambios en otros toolkits.
porque un instalador
- se requiere instalar muchos componentes a mano por el usuario final para una sola aplicación
- muchos instaladores pequeños
- difíciles de encontrar
- difícil encontrar las versiones exactas que funcionan en conjunto
- requiere instalarlos en un orden definido
- rezar
- algunas veces incluso haciendo todo bien puede no funcionar
- fácil de automatizar y documentar para replicar con cada nueva versión
- liberar al usuario final de los problemas para poder usar la aplicación
componentes requeridos
- python
- todas las librerías utilizadas por la aplicación
- py2exe
- nsis
- tiempo y suerte
instaladores
aquí se listan los links a los instaladores de todos los componentes usados en el ejemplo.
- http://python.org/ftp/python/2.6.6/python-2.6.6.msi
- http://sourceforge.net/projects/py2exe/files/py2exe/0.6.9/py2exe-0.6.9.win32-py2.6.exe/download
- http://ftp.gnome.org/pub/GNOME/binaries/win32/pycairo/1.8/pycairo-1.8.6.win32-py2.6.exe
- http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.20/pygobject-2.20.0.win32-py2.6.exe
- http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.16/pygtk-2.16.0+glade.win32-py2.6.exe
- http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.win32-py2.6.exe/download
- http://sourceforge.net/projects/gtk-win/files/GTK%2B%20Runtime%20Environment/GTK%2B%202.22/gtk2-runtime-2.22.0-2010-10-01-ash.exe/download
- http://sourceforge.net/projects/gtk-win/files/GTK%2B%20Themes%20Package/2009-09-07/gtk2-themes-2009-09-07-ash.exe/download
- http://prdownloads.sourceforge.net/nsis/nsis-2.46-setup.exe?download
orden de instalación
algunos instaladores son independientes de otros, pero para evitar posibles problemas recomiendo la instalación en el siguiente orden.
- python
- gtk-runtime
- gtk2-themes
- nsis
- pygobject
- pycairo
- pygtk
- pywin32
- py2exe
tareas extra
- setear la variable de entorno PATH para agregar el path a la instalación de python
- probar la instalación con una pequeña aplicación gtk
>>> import gtk
>>> w = gtk.Window()
>>> l = gtk.Label("asd")
>>> w.add(l)
>>> w.show_all()
>>> gtk.main()
prueba con una aplicación de ejemplo
Cree un repositorio con una aplicación de ejemplo para probar los pasos, la aplicación esta disponible en github acá:
http://github.com/marianoguerra/PyGtkOnWindows
pasos
- descargarla
- descomprimirla
- ejecutar python setup.py py2exe
- copiar los directorios lib y share de la instalación del runtime de gtk (no de la instalación de pygtk) al directorio dist
- copiar todos los archivos del directorio dll al directorio dist
- borrar los locales y temas no usados de los directorios copiados a dist (yo solo dejo el theme MS-Windows)
- crear la siguiente estructura de directorios dentro de dist: etc/gtk-2.0
- dentro de ese directorio crear un archivo llamado gtkrc con una linea como la siguiente dentro:
- gtk-theme-name = "MS-Windows"
- podes cambiar el tema usado manteniendo otro theme dentro de share/themes y cambiando el nombre del theme en gtkrc
- right click en ejemplo.nsi y seleccionar "Compile NSIS Script"
- right click en ejemplo-portable.nsi y seleccionar "Compile NSIS Script"
- deberías tener el instalador y la versión portable disponibles
- para probar que funciona correctamente, correr el instalador y la versión portable en una instalación de windows sin los paquetes que instalaste anteriormente
probar con una aplicación real
ahora para sentirlo mas real, creemos un instalador y una versión portable de
un programa real, en este caso, un proyecto personal llamado emesene 2
(http://www.emesene.org/).
pasos
- descargarlo de http://github.com/emesene/emesene
- descomprimirlo
- copiar setup.py and ez_setup.py al directorio emesene
- cd emesene
- correr python setup.py py2exe
- cd ..
- copiar los directorios lib y share de la instalación del runtime de gtk (no de la instalación de pygtk) al directorio dist
- copiar todos los archivos del directorio dll al directorio dist
- borrar los locales y temas no usados de los directorios copiados a dist (yo solo dejo el theme MS-Windows)
- crear la siguiente estructura de directorios dentro de dist: etc/gtk-2.0
- dentro de ese directorio crear un archivo llamado gtkrc con una linea como la siguiente dentro:
- gtk-theme-name = "MS-Windows"
- podes cambiar el tema usado manteniendo otro theme dentro de share/themes y cambiando el nombre del theme en gtkrc
- right click en emesene.nsi y seleccionar "Compile NSIS Script"
- right click en emesene-portable.nsi y seleccionar "Compile NSIS Script"
- deberías tener el instalador y la versión portable disponibles
- para probar que funciona correctamente, correr el instalador y la versión portable en una instalación de windows sin los paquetes que instalaste anteriormente
notas
- obtengo algunos de los dlls requeridos de portable python (http://www.portablepython.com/) e inkscape (http://inkscape.org/)
How to generate .exe files and installers for a python (and pygtk) applications
How to generate .exe files and installers for a python applications
This document describes the steps required to create an executable file from a
python program and how to build an installer and portable file from that
application.
The document assumes that the application is based on GTK but it should work
with minor changes for other toolkits.
why an installer
- many components are required to install by hand by the end user for a simple application
- a lot of small installers
- hard to find
- hard to match the exact versions that work together
- install them in the required order
- pray
- sometimes even doing everything right it may not work
- easy to automate and document to replicate with each new version
- free the end user from problems to use the app
required components
- python
- all the libraries used by the application
- py2exe
- nsis
- time and luck ;)
installers
here are listed the links to the installers of all the components used in the example.
- http://python.org/ftp/python/2.6.6/python-2.6.6.msi
- http://sourceforge.net/projects/py2exe/files/py2exe/0.6.9/py2exe-0.6.9.win32-py2.6.exe/download
- http://ftp.gnome.org/pub/GNOME/binaries/win32/pycairo/1.8/pycairo-1.8.6.win32-py2.6.exe
- http://ftp.gnome.org/pub/GNOME/binaries/win32/pygobject/2.20/pygobject-2.20.0.win32-py2.6.exe
- http://ftp.gnome.org/pub/GNOME/binaries/win32/pygtk/2.16/pygtk-2.16.0+glade.win32-py2.6.exe
- http://sourceforge.net/projects/pywin32/files/pywin32/Build%20214/pywin32-214.win32-py2.6.exe/download
- http://sourceforge.net/projects/gtk-win/files/GTK%2B%20Runtime%20Environment/GTK%2B%202.22/gtk2-runtime-2.22.0-2010-10-01-ash.exe/download
- http://sourceforge.net/projects/gtk-win/files/GTK%2B%20Themes%20Package/2009-09-07/gtk2-themes-2009-09-07-ash.exe/download
- http://prdownloads.sourceforge.net/nsis/nsis-2.46-setup.exe?download
installation order
some installers are independent from the others, but to avoid posible problems I recommend the installation in this order.
- python
- gtk-runtime
- gtk2-themes
- nsis
- pygobject
- pycairo
- pygtk
- pywin32
- py2exe
extra tasks
- set the PATH environment variable to add the path to the python installation
- test that the installation works with a simple gtk application
>>> import gtk
>>> w = gtk.Window()
>>> l = gtk.Label("asd")
>>> w.add(l)
>>> w.show_all()
>>> gtk.main()
test with a sample application
I created a repository with a sample application to test the steps, the application is available in github here:
http://github.com/marianoguerra/PyGtkOnWindows
steps
- download it
- unpack it
- run python setup.py py2exe
- copy the lib and share directory from the gtk runtime installation (not the pygtk installation) to the dist directory
- copy all the files from the dll directory to the dist directory
- remove unused locales and unused themes (I keep only ms theme)
- create the following dirs inside dist: etc/gtk-2.0
- inside that create a file called gtkrc with a line like this inside:
- gtk-theme-name = "MS-Windows"
- you can change the theme by keeping that theme inside share/themes and changing the name in gtkrc
- right click on ejemplo.nsi and select "Compile NSIS Script"
- right click on ejemplo-portable.nsi and select "Compile NSIS Script"
- you should have the installer and portable versions available
- to test that it works correctly, run the installer and portable versions in a windows installation without the packages you installed previously
test with a real application
now to make it feel more real let's create an installer and portable versions
for a real world program, in this case, a project of mine called emesene 2
(http://www.emesene.org/).
steps
- download it from http://github.com/emesene/emesene
- unpack it
- copy setup.py and ez_setup.py to the emesene directory
- cd to emesene
- run python setup.py py2exe
- cd ..
- copy the lib and share directory from the gtk runtime installation (not the pygtk installation) to the dist directory
- copy all the files from the dll directory to the dist directory
- remove unused locales and unused themes (I keep only ms theme)
- create the following dirs inside dist: etc/gtk-2.0
- inside that create a file called gtkrc with a line like this inside:
- gtk-theme-name = "MS-Windows"
- you can change the theme by keeping that theme inside share/themes and changing the name in gtkrc
- right click on emesene.nsi and select "Compile NSIS Script"
- right click on emesene-portable.nsi and select "Compile NSIS Script"
- you should have the installer and portable versions available
- to test that it works correctly, run the installer and portable versions in a windows installation without the packages you installed previously
notes
- I get some needed dlls from portable python (http://www.portablepython.com/) and inkscape (http://inkscape.org/)
Monday, October 25, 2010
it's coming
right now I have the installer and portable versions available, I need to test them some more.
if you really want to test it, follow the instructions in INSTALL_WINDOWS.txt and become the windows mantainer ;).
Sunday, October 24, 2010
maybe I forgot, where to report bugs/problems/requests
we are using the issue tracker of github:
http://github.com/emesene/emesene/issues
please check that your issue isn't already reported by someone else.
if you want to help us you could try to solve some of the issues.










