TWBlue, an accessible, open source and multiplatform twitter application.
Go to file
2015-11-28 09:54:58 -06:00
doc Added new languages to the doc generator 2015-11-28 09:47:24 -06:00
mysc Added windows dependencies submodule, added pa.c format files 2015-03-01 23:06:20 +01:00
scripts Added japanese, croatian and serbian (latin) languages to the installer 2015-10-19 12:47:52 +02:00
src Removed pocket related things 2015-11-28 09:54:58 -06:00
tools Updated documentation with translators list 2015-11-27 09:16:48 -06:00
windows-dependencies@571c37bbc1 Updated windows dependencies. Remember to run git submodule update before submiting new commits 2015-10-19 10:52:05 +02:00
.gitignore Libraries from keys are copied in setup 2015-04-12 00:03:51 -05:00
.gitmodules Comments in some functions and submodules 2015-02-25 08:39:06 -06:00
contributors.txt Added a new contributor 2015-08-06 12:07:30 -05:00
COPYING Added more detailed information about licenses 2015-11-27 08:05:41 -06:00
license.txt The new documentation system has been finished. Doc needs to be updated 2014-11-07 16:28:27 -06:00
README.md Added new packages to readme.md. Now setup.py adds wx localization files to the binary version. 2015-10-04 18:15:09 +02:00

TWBlue -

Copyright (C) 2015. Technow S.L.

TW Blue is an app designed to use Twitter simply and efficiently while using minimal system resources. With this app youll have access to twitter features such as:

  • Create, reply to, retweet and delete tweets,
  • Add and remove tweets from favourites,
  • Send and delete direct messages,
  • See your friends and followers,
  • Follow, unfollow, block and report users as spam,
  • Open a users timeline, which will allow you to get that users tweets separately,
  • Open URLs when attached to a tweet or direct message,
  • Play audio tweets
  • and more!

See TWBlue's webpage for more details.

Using TWBlue from sources

This document describes how to run tw blue from source, and, after that, how to build a binary version, which doesn't need Python and the other dependencies to run.

Required dependencies.

Although most dependencies can be found in the windows-dependencies directory, we provide links to their official websites. If you are cloning with git, don't forget to initialize and update the submodules to get the windows-dependencies folder. You can use these two commands to perform this task from git bash:
git submodule init
git submodule update

All the dependencies provided in this folder are prebuilt. If you want to build them from source, you will need Microsoft visual Studio 2008.

Dependencies packaged in windows installers

  • Python, version 2.7.10
    If you want to build both x86 and x64 binaries, you can install python x86 to C:\python27 and python x64 to C:\python27x64, for example.
  • wxPython for Python 2.7, version 3.0.2.0
  • Python windows extensions (pywin32) for python 2.7, build 219
  • Pycurl 7.19.5.1 for Python 2.7: 32-bit downloads, 64-bit downloads Note: the x64 version is in wheel format instead of executable installer, so you have to install it using pip. For example: C:\python27x64\scripts\pip install pycurl-7.19.5.1-cp27-none-win_amd64.whl
  • PyEnchant, version 1.6.6.
    x64 version has been built by TWBlue developers, so you only will find it in windows-dependencies folder

The windows installers are available only in the windows-dependencies folder

To build a binary version:

  • Py2exe for Python 2.7, version 0.6.9

Dependencies that must be installed using easy_install

setuptools install a script, called easy_install. You can find it in the python scripts directory. To install packages using easy_install, you have to navigate to the scripts directory using a command prompt, for example:

cd C:\python27x64\scripts

You can also add the scripts folder to your path environment variable.
Note: pip and setuptools are included in the Python installer since version 2.7.9.

After that, run the following command to install a package, replacing packagename with the names listed below:

easy_install -Z package

The -z switch unzips the package, instead of installing it compressed. If you add the --upgrade switch, you can upgrade a package to its latest version. The following packages need to be installed:
  • pypubsub
  • configobj
  • requests-oauthlib
  • future
  • pygeocoder
  • suds
  • arrow
  • goslate
  • markdown
  • pocket

easy_install will automatically get the additional libraries that these packages need to work properly. Run the following command to quickly install and upgrade all packages and their dependencies: easy_install -Z --upgrade six configobj goslate markdown future pocket suds requests oauthlib requests-oauthlib pypubsub pygeocoder arrow python-dateutil futures

Other dependencies

These dependencies are located in the windows-dependencies directory. You don't need to install or modify them.

  • Bootstrap 1.2.1: included in dependencies directory.
    This dependency has been built using pure basic 4.61. Its source can be found at http://hg.q-continuum.net/updater
  • oggenc2.exe, version 2.87
  • Microsoft Visual c++ 2008 redistributable dlls.

Dependencies required to build the installer

Running TW Blue from source

Now that you have installed all these packages, you can run TW Blue from source using a command prompt. Navigate to the repo's src directory, and type the following command:

python main.py

If necessary, change the first part of the command to reflect the location of your python executable. You can run TW Blue using python x86 and x64

Generating the documentation

To generate the documentation in html format, navigate to the doc folder inside this repo. After that, run this command: python generator.py The documentation will be generated, placing each language in a separate folder in the doc directory. Move these folders (for example de, en, es, fr, it, ...) to src/documentation, creating the directory if necesary. Also, copy the license.txt located in the root of the repo to the documentation folder.

Building a binary version

A binary version doesn't need python and the other dependencies to run, it's the same version that you will find on the TW Blue website if you download the zip files or the snapshot versions.

To build it, run the following command from the src folder:

python setup.py py2exe

You will find the binaries in the dist directory.

Building an installer

If you want to install TWBlue in your computer, you must create the installer first. Follow these steps:

  • Navigate to the src directory, and create a binary version for x86: C:\python27\python setup.py py2exe
  • Move the dist directory to the scripts folder in this repo, and rename it to twblue
  • Repeat these steps with Python for x64: C:\python27x64\python setup.py py2exe
  • Move the new dist directory to the scripts folder, and rename it to twblue64
  • Go to the scripts folder, right click on the twblue.nsi file, and choose compyle unicode NSIS script
  • This may take a while. After the process, you will find the installer in the scripts folder

How to generate a translation template

Run the gen_pot.bat file, located in the tools directory. Your python installation must be in your path environment variable. The pot file will appear in the tools directory.