mirror of
https://github.com/MCV-Software/TWBlue.git
synced 2024-11-26 12:53:12 -06:00
111 lines
5.0 KiB
Markdown
111 lines
5.0 KiB
Markdown
TWBlue -
|
||
======
|
||
|
||
Copyright (C) 2015. [Technow S.L.](https://www.technow.es)
|
||
|
||
TW Blue is an app designed to use Twitter simply and efficiently while using minimal system resources.
|
||
With this app you’ll 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 user’s timeline, which will allow you to get that user’s tweets separately,
|
||
* Open URLs when attached to a tweet or direct message,
|
||
* Play audio tweets
|
||
* and more!
|
||
|
||
See [TWBlue's webpage](http://twblue.es) 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,](http://python.org) 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](http://www.wxpython.org) for Python 2.7, version 3.0.2.0
|
||
* [Python windows extensions (pywin32)](http://www.sourceforge.net/projects/pywin32/) for python 2.7, build 219
|
||
* [Pycurl](http://pycurl.sourceforge.net) 7.19.5.1 for Python 2.7: [32-bit downloads,](https://pypi.python.org/pypi/pycurl/7.19.5.1) [64-bit downloads](http://www.lfd.uci.edu/~gohlke/pythonlibs/)
|
||
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,](http://pythonhosted.org/pyenchant/) version 1.6.6.
|
||
x64 version has been built by TW Blue 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](http://www.sourceforge.net/projects/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
|
||
|
||
easy_install will automatically get the additional libraries that these packages need to work properly.
|
||
|
||
#### 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,](http://www.rarewares.org/ogg-oggenc.php) version 2.87
|
||
* Microsoft Visual c++ 2008 redistributable dlls.
|
||
|
||
#### Dependencies required to build the installer
|
||
|
||
* [NSIS unicode,](http://www.scratchpaper.com/) version 2.46.5
|
||
|
||
### 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
|
||
|
||
### 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.
|
||
|
||
To build it, run the following command from the src folder:
|
||
|
||
python setup.py py2exe
|
||
|
||
You will find the binaries in the dist directory.
|
||
|
||
### 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.
|