Merge branch 'next-gen' of gitlab.com:twblue/twblue into next-gen

Update Japanese translation

.gitignore

@@ -17,4 +17,7 @@ src/Microsoft.VC90.MFC
 src/launcher.bat
 src/sounds/iOs
 release-snapshot/
-src/com_cache/
+src/com_cache/
+doc/strings.py
+doc/changelog.py
+env/

.gitlab-ci.yml

@@ -0,0 +1,123 @@
+variables:
+  GIT_SUBMODULE_STRATEGY: recursive
+  PYTHON: "C:\\python37\\python.exe"
+  NSIS: "C:\\program files (x86)\\nsis\\makensis.exe"
+
+stages:
+  - build
+  - make_installer
+  - upload
+
+twblue32:
+  tags:
+    - shared-windows
+    - windows
+    - windows-1809
+  before_script:
+    - Set-Variable -Name "time" -Value (date -Format "%H:%m")
+    - echo ${time}
+    - echo "started by ${GITLAB_USER_NAME}"
+    - choco install python --version 3.7.9 -y -ForceX86
+    - '&$env:PYTHON -V'
+    - '&$env:PYTHON -m pip install --upgrade pip'
+    - '&$env:PYTHON -m pip install --upgrade -r requirements.txt'
+  stage: build
+  interruptible: true
+  script:
+    # Create html documentation firstly.
+    - cd doc
+    - '&$env:PYTHON documentation_importer.py'
+    - cd ..\src
+    - '&$env:PYTHON ..\doc\generator.py'
+    - '&$env:PYTHON write_version_data.py'
+    - '&$env:PYTHON setup.py build'
+    - cd ..
+    - mkdir artifacts
+    - cd scripts
+    - '&$env:PYTHON make_archive.py'
+    - cd ..
+    - mv src/dist artifacts/TWBlue
+    - move src/twblue.zip artifacts/twblue_x86.zip
+    # Move the generated script nsis file to artifacts, so we won't need python when generating the installer.
+    - move scripts/twblue.nsi artifacts/twblue.nsi
+  only:
+    - tags
+  artifacts:
+    paths:
+      - artifacts
+    expire_in: 1 day
+
+twblue64:
+  tags:
+    - shared-windows
+    - windows
+    - windows-1809
+  before_script:
+    - Set-Variable -Name "time" -Value (date -Format "%H:%m")
+    - echo ${time}
+    - echo "started by ${GITLAB_USER_NAME}"
+    - choco install python --version 3.7.9 -y
+    - '&$env:PYTHON -V'
+    - '&$env:PYTHON -m pip install --upgrade pip'
+    - '&$env:PYTHON -m pip install --upgrade -r requirements.txt'
+  stage: build
+  interruptible: true
+  script:
+    # Create html documentation firstly.
+    - cd doc
+    - '&$env:PYTHON documentation_importer.py'
+    - cd ..\src
+    - '&$env:PYTHON ..\doc\generator.py'
+    - '&$env:PYTHON write_version_data.py'
+    - '&$env:PYTHON setup.py build'
+    - cd ..
+    - mkdir artifacts
+    - cd scripts
+    - '&$env:PYTHON make_archive.py'
+    - cd ..
+    - mv src/dist artifacts/TWBlue64
+    - move src/twblue.zip artifacts/twblue_x64.zip
+  only:
+    - tags
+  artifacts:
+    paths:
+      - artifacts
+    expire_in: 1 day
+
+generate_versions:
+  stage: make_installer
+  tags:
+    - shared-windows
+    - windows
+    - windows-1809
+  before_script:
+    - Set-Variable -Name "time" -Value (date -Format "%H:%m")
+    - echo ${time}
+    - echo "started by ${GITLAB_USER_NAME}"
+    - choco install nsis -y -ForceX86
+  script:
+    - move artifacts/TWBlue scripts/
+    - move artifacts/TWBlue64 scripts/
+    - move artifacts/twblue.nsi scripts/installer.nsi
+    - cd scripts
+    - '&$env:NSIS installer.nsi'
+    - move twblue_setup.exe ../artifacts
+  only:
+    - tags
+  artifacts:
+    paths:
+      - artifacts
+    expire_in: 1 day
+
+upload:
+  stage: upload
+  tags:
+    - linux
+  image: python
+  interruptible: true
+  script:
+    - cd artifacts
+    - python ../scripts/upload.py
+  only:
+    - tags
+    - schedules

COPYING

@@ -1,5 +1,5 @@
 Tw Blue is free software, licensed under the GNU GPL license, either version 2 or, at your option, any later version. You can view the license in the file named license.txt, or online at http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
-Copyright © 2013-2015. Manuel Cortéz
+Copyright © 2013-2018. Manuel Cortéz
 
 Documentation is written by Sukil Etxenike, Brian Hartgen and Bill Dengler, covered by the Creative Commons Attribution-NonCommercial-ShareAlike 2.5 license. You can read the license at https://creativecommons.org/licenses/by-nc-sa/2.5/
 

README.md

@@ -1,9 +1,9 @@
 TWBlue -
 ======
 
-Copyright (C) 2016. [Technow S.L.](https://www.technow.es)
+[![Build status](https://ci.appveyor.com/api/projects/status/fml5fu7h1fj8vf6l?svg=true)](https://ci.appveyor.com/project/manuelcortez/twblue)
 
-TW Blue is an app designed to use Twitter simply and efficiently while using minimal system resources.
+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, like, retweet and delete tweets,
@@ -24,56 +24,37 @@ This document describes how to run tw blue from source and how to build a binary
 ### 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.11  
-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 220
-* [PyEnchant,](http://pythonhosted.org/pyenchant/) version 1.6.6.  
-x64 version has been built by TWBlue developers, so you only will find it in windows-dependencies folder
+* [Python,](https://python.org) version 3.7.9  
+If you want to build both x86 and x64 binaries, you can install python x86 to C:\python38 and python x64 to C:\python38x64, for example.
 
-The windows installers are available only in the windows-dependencies folder
+#### Dependencies that must be installed using pip
 
-To build a binary version:
+Python installs a tool called Pip that allows to install packages in a simple way. You can find it in the python scripts directory. To install packages using Pip, you have to navigate to the scripts directory using a command prompt, for example:
 
-* [Py2exe](http://www.sourceforge.net/projects/py2exe/) for Python 2.7, version 0.6.9
+    `cd C:\python37x64\scripts`
 
-#### Dependencies that must be installed using easy_install
-
-setuptools installs 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.
+	You can also add the scripts folder to your path environment variable or choose the corresponding option when installing Python.  
 	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:
+Pip is able to install packages listed in a special text file, called the requirements file. To install all remaining dependencies, perform the following command:
 
-    easy_install -Z package
+    `pip install -r requirements.txt`
 
-	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:
+Note that if you perform the command from the path where Pip is located, you need to specify the path to your Tw Blue root folder where the requirements file is located, for example:
 
-* pypubsub
-* configobj
-* requests-oauthlib
-* requests-toolbelt
-* future
-* pygeocoder
-* suds
-* arrow==0.6
-* markdown
-* winpaths
-* microsofttranslator
+    `pip install -r D:\repos\TwBlue\requirements.txt`
 
-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 suds requests oauthlib requests-oauthlib requests-toolbelt pypubsub pygeocoder arrow==0.6 python-dateutil futures markdown microsofttranslator winpaths
+Pip will automatically get the additional libraries that the listed packages need to work properly.  
+If you need to update your dependencies, perform the following command:
+
+    `pip install --upgrade -r requirements.txt`
 
 #### Other dependencies
 
@@ -82,34 +63,42 @@ These dependencies are located in the windows-dependencies directory. You don't
 * 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.
+* Microsoft Visual c++ 2019 redistributable dlls.
+* VLC plugins and DLL libraries.
 
 #### Dependencies required to build the installer
 
-* [NSIS unicode,](http://www.scratchpaper.com/) version 2.46.5
+* [NSIS,](http://nsis.sourceforge.net/) version 3.04
 
 #### Dependencies required to build the portableApps.com format archive
 
-* [NSIS Unicode Portable,](http://portableapps.com/apps/development/nsis_portable) version 2.46.5 rev 3
-* [PortableApps.com Launcher,](http://portableapps.com/apps/development/portableapps.com_launcher) version 2.2
-* [PortableApps.com Installer,](http://portableapps.com/apps/development/portableapps.com_installer) version 3.1.3
+* [NSIS Portable,](http://portableapps.com/apps/development/nsis_portable) version 3.03
+* [PortableApps.com Launcher,](http://portableapps.com/apps/development/portableapps.com_launcher) version 2.2.1
+* [PortableApps.com Installer,](http://portableapps.com/apps/development/portableapps.com_installer) version 3.5.11
 
 Important! Install these 3 apps into the same folder, otherwise you won't be able to build the pa.c version. For example: D:\portableApps\NSISPortable, D:\PortableApps\PortableApps.com installer, ...
 
+#### Dependencies to make the spell checker multilingual ####
+
+In order to add the support for spell checking in more languages than english you need to add some additional dictionaries to pyenchant. These are located on the dictionaries folder under windows-dependencies. Simply copy them to the share/enchant/myspell folder located in your enchant installation. They will be automatically copied when building a binary version.
+
 ### 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:
+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
+    `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
+	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.
+To generate the documentation in html format, navigate to the doc folder inside this repo. After that, run these commands:  
+
+    `python document_importer.py`  
+    `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 necessary.  
+Also, copy the `license.txt` file located in the root of the repo to the documentation folder.
 
 ### Building a binary version
 
@@ -117,7 +106,7 @@ A binary version doesn't need python and the other dependencies to run, it's the
 
 To build it, run the following command from the src folder:
 
-    python setup.py py2exe
+    `python setup.py build`
 
 	You will find the binaries in the dist directory.
 
@@ -125,9 +114,9 @@ To build it, run the following command from the src folder:
 
 If you want to install TWBlue on 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
+* Navigate to the src directory, and create a binary version for x86: C:\python37\python setup.py build
 * 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
+* Repeat these steps with Python for x64: C:\python37x64\python setup.py build
 * 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
@@ -140,9 +129,9 @@ Run the gen_pot.bat file, located in the tools directory. Your python installati
 
 If you want to have TWBlue on your PortableApps.com platform, follow these steps:
 
-* Navigate to the src directory, and create a binary version for x86: C:\python27\python setup.py py2exe
+* Navigate to the src directory, and create a binary version for x86: C:\python37\python setup.py build
 * Move the dist directory to the misc\pa.c format\app folder in this repo, and rename it to twblue
-* Repeat these steps with Python for x64: C:\python27x64\python setup.py py2exe
+* Repeat these steps with Python for x64: C:\python37x64\python setup.py build
 * Move the new dist directory to the misc\pa.c format\app folder, and rename it to twblue64
 * Run the PortableApps.com Launcher Generator, and follow the wizard. Choose the pa.c format folder and continue to generate the launcher. If the wizard is completed, you will see a file named TWBlue portable.exe inside the pa.c format folder.
 * Run the PortableApps.com Installer, and follow the wizard. As in the above step, choose the pa.c format folder. When it completes, you will see a file named TWBluePortable_x.y.paf.exe inside the misc folder, where x.y is the version number.

contributors.txt

@@ -1,12 +1,8 @@
 Manuel E. Cortéz
 Bill Dengler
-Johana Hidrobo
-Marcelo Sosa
-Isabel del Castillo
 José Manuel Delicado
 David Picón
 Vicente Llopis
-Javier Dorado
 Guillem León
 Marco Serrano
 Bryner Villalobos
@@ -35,11 +31,13 @@ Anibal Hernández
 Sussan Leiva
 Brian Hartgen
 PEDRO REINA COLOBON
-Moora-Moora Arrilla
 Blake Oliver
 Steffen Schultz
 Riku
 Burak Yüksek
 florian Ionașcu
 Christian Leo Mameli
-Natalia Hedlund (Наталья Хедлунд)
+Natalia Hedlund (Наталья Хедлунд)
+Valeria (Валерия)
+Oreonan
+Artem Plaksin (maniyax)

doc/application.py

@@ -1,18 +0,0 @@
-# -*- coding: utf-8 -*-
-name = 'TWBlue'
-snapshot = False
-if snapshot == False:
- version = "0.84"
- update_url = 'http://twblue.es/updates/twblue_ngen.json'
- mirror_update_url = 'https://raw.githubusercontent.com/manuelcortez/TWBlue/next-gen/updates/stable.json'
-else:
- version = "10.99"
- update_url = 'http://twblue.es/updates/snapshots_ngen.json'
- mirror_update_url = 'https://raw.githubusercontent.com/manuelcortez/TWBlue/next-gen/updates/snapshots.json'
-author = u"Manuel Cortéz"
-authorEmail = "manuel@manuelcortez.net"
-copyright = u"Copyright (C) 2015, Technow S.L. \nCopyright (C) 2013-2015, Manuel cortéz."
-description = unicode(name+" is an app designed to use Twitter simply and efficiently while using minimal system resources. This app provides access to most Twitter features.")
-translators = [u"Bryner Villalobos, Bill Dengler (English)", u"Mohammed Al Shara (Arabic)", u"Joan Rabat, Juan Carlos Rivilla (Catalan)", u"Manuel cortéz (Spanish)", u"Sukil Etxenike Arizaleta (Basque)", u"Jani Kinnunen (finnish)", u"Rémy Ruiz (French)", u"Juan Buño (Galician)", u"Steffen Schultz (German)", u"Robert Osztolykan (Hungarian)", u"Paweł Masarczyk (Polish)", u"Odenilton Júnior Santos (Portuguese)", u"Alexander Jaszyn (Russian)", u"Burak (Turkish)"]
-url = u"http://twblue.es"
-report_bugs_url = "http://twblue.es/bugs/api/soap/mantisconnect.php?wsdl"

doc/changelog.md

@@ -0,0 +1,258 @@
+TWBlue Changelog
+
+## changes in this version
+
+* TWBlue should retrieve tweets from threads and conversations in a more reliable way. Tweets in the same thread (made by the same author) will be sorted correctly, although replies to the thread (made by different people) may not be ordered in the same way they are displayed in Twitter apps. ([#417](https://github.com/manuelcortez/TWBlue/issues/417))
+* When creating a filter, TWBlue will show an error if user has not provided a name for the filter. Before, unnamed filters were a cause of config breaks in the application.
+* It is again possible to read the changelog for TWBlue from the help menu in the menu bar.
+* fixed a bug when clearing the direct messages buffer. ([#418](https://github.com/manuelcortez/TWBlue/issues/418))
+* fixed an issue that was making TWBlue to show incorrectly titles for trending topic buffers upon startup. ([#421](https://github.com/manuelcortez/TWBlue/issues/421))
+* fixed an issue that was making users of the graphical user interface to delete a buffer if a trends buffer was opened in the same session.
+* Updated Spanish, Japanese and french translations.
+
+## Changes in Version 2021.10.30
+
+* Fixed many errors in the way we compile TWBlue, so users of 64 bits systems and particularly windows 7 users would be able to install TWBlue again. In case of issues with versions prior to 2021.10.30, please remove everything related to TWBlue (except configs) and reinstall the version 2021.10.30 to fix any possible error. This step won't be needed again in 23 months. ([#416,](https://github.com/manuelcortez/TWBlue/issues/416), [#415,](https://github.com/manuelcortez/TWBlue/issues/415))
+* fixed an issue that was making impossible to manually add an user to the autocomplete users database.
+* Started to improve support to conversations by searching for conversation_id.
+
+## changes in version 2021.10.27
+
+* Added an user alias manager, located in the application menu in the menu bar. From this dialog, it is possible to review, add, edit or remove user aliases for the current account. ([#401](https://github.com/manuelcortez/TWBlue/issues/401))
+* TWBlue now closes the VLC player window automatically when a video reaches its end. ([#399](https://github.com/manuelcortez/TWBlue/issues/399))
+* After a lot of time, TWBlue now uses a new default Soundpack, called FreakyBlue. This soundpack will be set by default in all new sessions created in the application. Thanks to [Andre Louis](https://twitter.com/FreakyFwoof) for the pack. ([#247](https://github.com/manuelcortez/TWBlue/issues/247))
+* When reading a tweet, if the tweet contains more than 2 consecutive mentions, TWBlue will announce how many more users the tweet includes, as opposed to read every user in the conversation. You still can display the tweet to read all users.
+* In the tweet displayer, It is possible to copy a link to the current tweet or person by pressing a button called "copy link to clipboard".
+* Added a keymap capable to work under Windows 11. ([#391](https://github.com/manuelcortez/TWBlue/pull/391))
+* Added user aliases to TWBlue. This feature allows you to rename user's display names on Twitter, so the next time you'll read an user it will be announced as you configured. For adding an alias to an user, select the "add alias" option in the user menu, located in the menu bar. This feature works only if you have set display screen names unchecked. Users are displayed with their display name in people buffers only. This action is supported in all keymaps, although it is undefined by default. ([#389](https://github.com/manuelcortez/TWBlue/pull/389))
+* There are some changes to the autocomplete users feature:
+    * Now users can search for twitter screen names or display names in the database.
+* It is possible to undefine keystrokes in the current keymap in TWBlue. This allows you, for example, to redefine keystrokes completely.
+* We have changed our Geocoding service to the Nominatim API from OpenStreetMap. Addresses present in tweets are going to be determined by this service, as the Google Maps API now requires an API key. ([#390](https://github.com/manuelcortez/TWBlue/issues/390))
+* Added a limited version of the Twitter's Streaming API: The Streaming API will work only for tweets, and will receive tweets only by people you follow. Protected users are not possible to be streamed. It is possible that during high tweet traffic, the Stream might get disconnected at times, but TWBlue should be capable of detecting this problem and reconnecting the stream again. ([#385](https://github.com/manuelcortez/TWBlue/pull/385))
+* Fixed an issue that made TWBlue to not show a dialog when attempting to show a profile for a suspended user. ([#387](https://github.com/manuelcortez/TWBlue/issues/387))
+* Added support for Twitter audio and videos: Tweets which contains audio or videos will be detected as audio items, and you can playback those with the regular command to play audios. ([#384,](https://github.com/manuelcortez/TWBlue/pull/384))
+* We just implemented some changes in the way TWBlue handles tweets in order to reduce its RAM memory usage [#380](https://github.com/manuelcortez/TWBlue/pull/380):
+    * We reduced the tweets size by storing only the tweet fields we currently use. This should reduce tweet's size in memory for every object up to 75%.
+    * When using the cache database to store your tweets, there is a new setting present in the account settings dialog, in the general tab. This setting allows you to control whether TWBlue will load the whole database into memory (which is the current behaviour) or not.
+        * Loading the whole database into memory has the advantage of being extremely fast to access any element (for example when moving through tweets in a buffer), but it requires more memory as the tweet buffers grow up. This should, however, use less memory than before thanks to the optimizations performed in tweet objects. If you have a machine with enough memory, this should be a good option for your case.
+        * If you uncheck this setting, TWBlue will read the whole database from disk. This is significantly slower, but the advantage of this setting is that it will consume almost no extra memory, no matter how big is the tweets dataset. Be ware, though, that TWBlue might start to feel slower when accessing elements (for example when reading tweets) as the buffers grow up. This setting is suggested for computers with low memory or for those people not wanting to keep a really big amount of tweets stored.
+* Changed the label in the direct message's text control so it will indicate that the user needs to write the text there, without referring to any username in particular. ([#366,](https://github.com/manuelcortez/TWBlue/issues/366))
+* TWBlue will take Shift+F10 again as the contextual menu key in the list of items in a buffer. This stopped working after we have migrated to WX 4.1. ([#353,](https://github.com/manuelcortez/TWBlue/issues/353))
+* TWBlue should render correctly retweets of quoted tweets. ([#365,](https://github.com/manuelcortez/TWBlue/issues/365))
+* Fixed an error that was causing TWBlue to be unable to output to screen readers at times. ([#369,](https://github.com/manuelcortez/TWBlue/issues/369))
+* Fixed autocomplete users feature. ([#367,](https://github.com/manuelcortez/TWBlue/issues/367))
+* Fixed error when displaying an URL at the end of a line, when the tweet or direct message contained multiple lines. Now the URL should be displayed correctly. ([#305,](https://github.com/manuelcortez/TWBlue/issues/305) [#272,](https://github.com/manuelcortez/TWBlue/issues/272))
+* TWBlue has been migrated completely to Python 3 (currently, the software builds with Python 3.8).
+* TWBlue should be restarted gracefully. Before, the application was alerting users of not being closed properly every time the application restarted by itself.
+* If TWBlue attemps to load an account with invalid tokens (this happens when reactivating a previously deactivated account, or when access to the ap is revoqued), TWBlue will inform the user about this error and will skip the account. Before, the app was unable to start due to a critical error. ([#328,](https://github.com/manuelcortez/TWBlue/issues/328))
+* When sending a direct message, the title of the window will change appropiately when the recipient is edited. ([#276,](https://github.com/manuelcortez/TWBlue/issues/276))
+* URL'S in user profiles are expanded automatically. ([#275,](https://github.com/manuelcortez/TWBlue/issues/275))
+* TWBlue now uses [Tweepy,](https://github.com/tweepy/tweepy) to connect with Twitter. We have adopted this change in order to support Twitter'S API V 2 in the very near future. ([#333,](https://github.com/manuelcortez/TWBlue/issues/337) [#347](https://github.com/manuelcortez/TWBlue/pull/347))
+* TWBlue can upload images in Tweets and replies again. ([#240,](https://github.com/manuelcortez/TWBlue/issues/240))
+* Fixed the way we use to count characters in Twitter. The new methods in TWBlue take into account special characters and URLS as documented in Twitter. ([#199,](https://github.com/manuelcortez/TWBlue/issues/199) [#315](https://github.com/manuelcortez/TWBlue/issues/315))
+* Proxy support now works as expected.
+* Changed translation service from yandex.translate to Google Translator. ([#355,](https://github.com/manuelcortez/TWBlue/issues/355))
+* Improved method to load direct messages in the buffers. Now it should be faster due to less calls to Twitter API performed from the client.
+* And more. ([#352,](https://github.com/manuelcortez/TWBlue/issues/352))
+
+## Changes in version 0.95
+
+* TWBlue can open a Tweet or user directly in Twitter. There is a new option in the context menu for people and tweet buffers, and also, the shortcut control+win+alt+Enter will open the focused item in Twitter.
+* Some keystrokes were remapped in the Windows 10 Keymap:
+    * Read location of a tweet: Ctrl+Win+G. ([#177](https://github.com/manuelcortez/TWBlue/pull/177))
+    * Open global settings dialogue: Ctrl+Win+Alt+O.
+    * Mute/unmute current session: Control + Windows + Alt + M.
+* Fixed an error that was preventing TWBlue to load the direct messages buffer if an user who sent a message has been deleted.
+* Added support for playing audios posted in [AnyAudio.net](http://anyaudio.net) directly from TWBlue. Thanks to [Sam Tupy](http://www.samtupy.com/)
+* Custom buffer ordering will not be reset every time the application restarts after an account setting has been modified.
+* When adding or removing an user from a list, it is possible to press enter in the focused list instead of having to search for the "add" or "delete" button.
+* Quoted and long tweets are displayed properly in the sent tweets buffer after being send. ([#253](https://github.com/manuelcortez/TWBlue/issues/253))
+* Fixed an issue that was making the list manager keystroke unable to be shown in the keystroke editor. Now the keystroke is listed properly. ([#260](https://github.com/manuelcortez/TWBlue/issues/260))
+* The volume slider, located in the account settings of TWBlue, now should decrease and increase value properly when up and down arrows are pressed. Before it was doing it in inverted order. ([#261](https://github.com/manuelcortez/TWBlue/issues/261))
+* autoreading has been redesigned to work in a similar way for almost all buffers. Needs testing. ([#221](https://github.com/manuelcortez/TWBlue/issues/221))
+* When displaying tweets or direct messages, a new field has been added to show the date when the item has been posted to Twitter.
+* Added support for deleting direct messages by using the new Twitter API methods.
+* When quoting a retweet, the quote will be made to the original tweet instead of the retweet.
+* If the sent direct messages buffer is hidden, TWBlue should keep loading everything as expected. ([#246](https://github.com/manuelcortez/TWBlue/issues/246))
+* There is a new soundpack, called FreakyBlue (Thanks to [Andre Louis](https://twitter.com/FreakyFwoof)) as a new option in TWBlue. This pack can be the default in the next stable, so users can take a look and share their opinion in snapshot versions. ([#247](https://github.com/manuelcortez/TWBlue/issues/247))
+* There is a new option in the help menu that allows you to visit the soundpacks section in the TWBlue website. ([#247](https://github.com/manuelcortez/TWBlue/issues/247))
+* When reading location of a geotagged tweet, it will be translated for users of other languages. ([#251](https://github.com/manuelcortez/TWBlue/pull/251))
+* When there are no more items to retrieve in direct messages and people buffers, a message will announce it.
+* Fixed an issue reported by some users that was making them unable to load more items in their direct messages.
+* It is possible to add a tweet to the likes buffer from the menu bar again.
+* Tweets, replies and retweets will be added to sent tweets right after being posted in Twitter.
+* Extended Tweets should be displayed properly in list buffers.
+
+## Changes in version 0.94
+
+* Added an option in the global settings dialog to disable the Streaming features of TWBlue. TWBlue will remove all Streaming features after August 16, so this option will give people an idea about how it will be. ([#219](https://github.com/manuelcortez/TWBlue/issues/219))
+* Due to Twitter API changes, Switched authorisation method to Pin-code based authorisation. When you add new accounts to TWBlue, you will be required to paste a code displayed in the Twitter website in order to grant access to TWBlue. ([#216](https://github.com/manuelcortez/TWBlue/issues/216))
+* In order to comply with latest Twitter changes, TWBlue has switched to the new method used to send and receive direct messages, according to issue [#215.](https://github.com/manuelcortez/twblue/issues/215)
+    * The new method does not allow direct messages to be processed in real time. Direct messages will be updated periodically.
+* After august 16 or when streaming is disabled, the events buffer will no longer be created in TWBlue.
+* You can configure frequency for buffer updates in TWBlue. By default, TWBlue will update all buffers every 2 minutes, but you can change this setting in the global settings dialog. ([#223](https://github.com/manuelcortez/TWBlue/issues/223))
+* Added a new tab called feedback, in the account settings dialog. This tab allows you to control whether automatic speech or Braille feedbak in certain events (mentions and direct messages received) is enabled. Take into account that this option will take preference over automatic reading of buffers and any kind of automatic output. ([#203](https://github.com/manuelcortez/TWBlue/issues/203))
+* The spell checking dialog now has access keys defined for the most important actions. ([#211](https://github.com/manuelcortez/TWBlue/issues/211))
+* TWBlue now Uses WXPython 4.0.1. This will allow us to migrate all important components to Python 3 in the future. ([#207](https://github.com/manuelcortez/TWBlue/issues/207))
+* When you quote a Tweet, if the original tweet was posted with Twishort, TWBlue should display properly the quoted tweet. Before it was displaying the original tweet only. ([#206](https://github.com/manuelcortez/TWBlue/issues/206))
+* It is possible to filter by retweets, quotes and replies when creating a new filter.
+* Added support for playing youtube Links directly from the client. ([#94](https://github.com/manuelcortez/TWBlue/issues/94))
+* Replaced Bass with libVLC for playing URL streams.
+* the checkbox for indicating whether TWBlue will include everyone in a reply or not, will be unchecked by default.
+* You can request TWBlue to save the state for two checkboxes: Long tweet and mention all, from the global settings dialogue.
+* For windows 10 users, some keystrokes in the invisible user interface have been changed or merged:
+    * control+Windows+alt+F will be used for toggling between adding and removing a tweet to user's likes. This function will execute the needed action based in the current status for the focused tweet.
+* TWBlue will show an error if something goes wrong in an audio upload.
+* And more. ([#171,](https://github.com/manuelcortez/TWBlue/issues/171) 
+
+## Changes in version 0.93
+
+* A new soundpack has been added to TWBlue. Thanks to [@ValeriaK305](https://twitter.com/ValeriaK305)
+* In the Windows 10 keymap, we have changed some default keystrokes as windows now uses some previously assigned shortcuts:
+    * For liking a tweet, press Control+Windows+alt+f
+    * for opening a trends buffer, press control+Windows+T
+* TWBlue has received improvements in some functions for handling extended tweets, long tweets and quoted retweets. It should render some tweets in a better way.
+* In the spell checker module, there is a new button that will allow you to add your own words to your personal dictionary so the module won't mark them as mispelled the next time you will check spelling.
+* Added filtering capabilities to TWBlue. ([#102](https://github.com/manuelcortez/TWBlue/issues/102))
+    * You can create a filter for the current buffer from the buffer menu in the menu bar. At this moment, invisible interface does not have any shorcut for this.
+    * You can create filters by word or languages.
+    * For deleting already created filters, you can go to the filter manager in the buffer menu and delete the filters you won't need.
+* Links should be opened properly in quoted tweets ([#167,](https://github.com/manuelcortez/TWBlue/issues/167) [#184](https://github.com/manuelcortez/TWBlue/issues/184))
+* Increased display name limit up to 50 characters in update profile dialog.
+* When authorising an account, you will see a dialogue with a cancel button, in case you want to abort the process. Also, NVDA will not be blocked when the process starts. ([#101](https://github.com/manuelcortez/TWBlue/issues/101))
+* In the translator module, the list of available languages is fetched automatically from the provider. That means all of these languages will work and there will not be inconsistencies. Also we've removed the first combo box, because the language is detected automatically by Yandex'S API. ([#153](https://github.com/manuelcortez/TWBlue/issues/153))
+* Trending topics, searches and conversation buffers will use mute settings set for the session in wich  they were opened. ([#157](https://github.com/manuelcortez/TWBlue/issues/157))
+* The Tweet limit is now 280 characters lenght instead 140. It means you can tweet longer tweets. ([#172](https://github.com/manuelcortez/TWBlue/issues/172))
+* Per popular request, Status for mention to all and long tweet checkboxes will not be saved in settings. ([#170](https://github.com/manuelcortez/TWBlue/issues/170))
+* Fixed a problem that was making TWBlue unable to start if it was being ran in Windows with Serbian language. ([#175](https://github.com/manuelcortez/TWBlue/issues/175))
+* Added Danish translation.
+* And more. ([#156,](https://github.com/manuelcortez/TWBlue/issues/156) [#163,](https://github.com/manuelcortez/TWBlue/issues/163) [#159,](https://github.com/manuelcortez/TWBlue/issues/159) [#173,](https://github.com/manuelcortez/TWBlue/issues/173) [#174,](https://github.com/manuelcortez/TWBlue/issues/174) [#176,](https://github.com/manuelcortez/TWBlue/issues/176))
+
+## changes in version 0.91 and 0.92
+
+* Fixed incorrect unicode handling when copying tweet to clipboard. ([#150](https://github.com/manuelcortez/TWBlue/issues/150))
+* TWBlue will show an error when trying to open a timeline for a suspended user. ([#128](https://github.com/manuelcortez/TWBlue/issues/128))
+* Removed TwUp as service as it no longer exists. ([#112](https://github.com/manuelcortez/TWBlue/issues/112))
+* Release audio files after uploading them. ([#130](https://github.com/manuelcortez/TWBlue/issues/130))
+* Now TWBlue will use Yandex's translation services instead microsoft translator. ([#132](https://github.com/manuelcortez/TWBlue/issues/132))
+* SndUp users will be able to upload audio in their account by using their API Key again. ([#134](https://github.com/manuelcortez/TWBlue/issues/134))
+* old tweets shouldn't be added as new items in buffers. ([#116,](https://github.com/manuelcortez/TWBlue/issues/116)) ([#133](https://github.com/manuelcortez/TWBlue/issues/133))
+* All mentionned users should be displayed correctly in Twishort's long tweets. ([#116,](https://github.com/manuelcortez/TWBlue/issues/116)) ([#135](https://github.com/manuelcortez/TWBlue/issues/135))
+* It is possible to select a language for OCR service from the extras panel, in the account settings dialogue. You can, however, set this to detect automatically. OCR should work better in languages with special characters or non-english symbols. ([#107](https://github.com/manuelcortez/TWBlue/issues/107))
+* Fixed a problem with JAWS for Windows and TWBlue. Now JAWS will work normally in this update. [#100](https://github.com/manuelcortez/twblue/issues/100)
+* And more ([#136,](https://github.com/manuelcortez/TWBlue/issues/136))
+
+## Changes in version 0.90
+
+* Fixed a bug in long tweet parsing that was making TWBlue to disconnect the streaming API. ([#103](https://github.com/manuelcortez/TWBlue/issues/103))
+* Now OCR will work in images from retweets. It fixes a bug where TWBlue was detecting images but couldn't apply OCR on them. ([#105](https://github.com/manuelcortez/TWBlue/issues/105))
+* TWBlue won't try to load tweets already deleted, made with Twishort. Before, if someone posted a long tweet but deleted it in the Twishort's site, TWBlue was trying to load the tweet and it was causing problems in all the client. ([#113](https://github.com/manuelcortez/TWBlue/issues/113))
+* TWBlue shows an error message when you try to view the profile of an user that does not exist or has been suspended. ([#114,](https://github.com/manuelcortez/TWBlue/issues/114) [#115](https://github.com/manuelcortez/TWBlue/issues/115))
+* The spellchecker module should select the right language when is set to "user default". ([#117](https://github.com/manuelcortez/TWBlue/issues/117))
+* Image description will be displayed in retweets too. ([#119](https://github.com/manuelcortez/TWBlue/issues/119))
+* When reading a long tweet, you shouldn't read strange entities anymore. ([#118](https://github.com/manuelcortez/twblue/issues/118))
+* TWBlue will not try to load timelines if the user is blocking you. ([#125](https://github.com/manuelcortez/twblue/issues/125))
+
+## Changes in version 0.88 and 0.89
+
+* Fixed more issues with streams and reconnections.
+* newer updates will indicate the release date in the updater.
+* Changes to keystrokes are reflected in keystroke editor automatically.
+* In replies with multiple users, if the mention to all checkbox is unchecked, you will see a checkbox per user so you will be able to control who will be mentioned in the reply.
+* Fixed a bug that caused duplicated user mentions in replies when the tweet was made with Twishort.
+* Retweets should be displayed normally again when the originating tweet is a Twishort's long tweet.
+* Changed the way TWBlue saves user timelines in configuration. Now it uses user IDS instead usernames. With user IDS, if an user changes the username, TWBlue still will create his/her timeline. This was not possible by using usernames.
+* Added a new setting in the account settings dialogue that makes TWBlue to show twitter usernames instead the full name.
+* Added OCR in twitter pictures. There is a new item in the tweet menu that allows you to extract and display text in images. Also the keystroke alt+Win+o has been added for the same purpose from the invisible interface.
+* Now TWBlue will play a sound when the focused tweet contains  images.
+* Your own quoted tweets will not appear in the mentions buffer anymore.
+* The config file is saved in a different way, it should fix the bug where TWBlue needs to be restarted after the config folder is deleted.
+* Mentioning people from friends or followers buffers works again.
+* Support for proxy servers has been improved. Now TWBlue supports http, https, socks4 and socks5 proxies, with and without autentication.
+
+## Changes in version 0.87
+
+* Fixed stream connection errors.
+* Now TWBlue can handle properly a reply to the sender without including all other mentioned users.
+* Updated translations.
+* The status of the mention to all checkbox will be remembered the next time you  reply to multiple users.
+
+## Changes in version 0.86
+
+* Fixed a very important security issue. Now TWBlue will send tweets to twishort without using any other server.
+* When you add a comment to a tweet, it will be sent as a quoted tweet, even if your reply plus the original tweet is not exceeding 140 characters.
+* Updated windows 10 keymap for reflecting changes made in the last windows 10 build.
+* Added last changes in the twitter API.
+* When replying, it will not show the twitter username in the text box. When you send the tweet, the username will be added automatically.
+* When replying to multiple users, you'll have a checkbox instead a button for mentioning all people. If this is checked, twitter usernames will be added automatically when you send your reply.
+
+## Changes in version 0.85
+
+* Long and quoted tweets should be displayed properly In lists.
+* The connection should be more stable.
+* Added an autostart option in the global settings dialogue.
+* Updated translation.
+* Updated russian documentation.
+* Tweets in cached database should be loaded properly.
+* Added some missed dictionaries for spelling correction.
+* Timelines, lists and other buffer should be created in the right order at startup.
+
+## Changes in version 0.84 
+
+* More improvements in quoted and long tweets.
+* Updated translations: Russian, Italian, French, Romanian, Galician and Finnish.
+* Improvements in the audio uploader module: Now it can handle audio with non-english characters.
+* the title of the window should be updated properly when spellcheck, translate or shorten/unshorten URL buttons are pressed.
+* the bug that changes the selected tweet in the home timeline shouldn't be happening so often.
+
+## Changes in version 0.82 and 0.83
+
+* If the tweet source (client) is an application with unicode characters (example: российская газета) it will not break the tweet displayer.
+* Added a new field for image description in tweet displayer. When available, it will show description for images posted in tweets.
+* users can add image descriptions to their photos. When uploading an image, a dialog will show for asking a description.
+* Redesigned upload image dialog.
+* Fixed photo uploads when posting tweets.
+* When getting tweets for a conversation, ignores deleted tweets or some errors, now TWBlue will try to get as much tweets as possible, even if some of these are no longer available.
+* Added audio playback from soundcloud.
+* Now the session mute option don't makes the screen reader speaks.
+* Fixed the direct message dialog. Now it should be displayed properly.
+* when a tweet is deleted in twitter, TWBlue should reflect this change and delete that tweet in every buffer it is displayed.
+* If your session is broken, TWBlue will be able to remove it automatically instead just crashing.
+* audio uploader should display the current progress.
+* users can disable the check for updates feature at startup from the general tab, in the global settings dialogue.
+* The invisible interface and the window should be synchronized when the client reconnects.
+* The documentation option in the systray icon should be enabled.
+* In trending buffers, you can press enter for posting a tweet about  the focused trend.
+* Updated russian documentation and main program interface (thanks to Natalia Hedlund (Наталья Хедлунд), [@lifestar_n](https://twitter.com/lifestar_n) in twitter)
+* updated translations.
+
+## Changes in Version 0.81
+
+* Updated translations
+* The updater module has received some improvements. Now it includes a Mirror URL for checking updates  if the main URL is not available at the moment. If something is wrong and both locations don't work, the program will start anyway.
+* some GUI elements now use keyboard shortcuts for common actions.
+* fixed a bug in the geolocation dialog.
+* the chicken nugget keymap should work properly.
+* Added a new soundpack to the default installation of TWBlue, thanks to [@Deng90](https://twitter.com/deng90)
+* Now the changelog is  written in an html File.
+* Added some missed dictionaries in last version for the spell checking feature.
+* Trimmed the beginnings of the sounds in the default soundpack. Thanks to [@masonasons](https://github.com/masonasons)
+* Added Opus support for sound playback in TWBlue. Thanks to [@masonasons](https://github.com/masonasons)
+* Added a source field in view tweet dialogue. Thanks to [@masonasons](https://github.com/masonasons)
+* You can load previous items in followers and friend buffers for others.
+* The Spell Checker dialogue should not display an error message when you have set "default language" in the global settings dialogue if your language is supported [#168](http://twblue.es/bugs/view.php?id=168)
+* Updated romanian translation.
+* Some code cleanups.
+* The bug reports feature is fully operational again.
+* TWBlue should work again for users that contains special characters in windows usernames.
+* Added more options for the tweet searches.
+* Added play_audio to the keymap editor.
+* Windows key is no longer required in the keymap editor
+* Switched to the Microsoft translator.
+* You can update the current buffer by pressing ctrl+win+shift+u in the default keymap or in the buffer menu.
+* Changed some keystrokes in the windows 10 default keymap
+* New followers and friends buffer for user timelines.
+
+---
+Copyright © 2014-2021, Manuel Cortez.

doc/documentation_importer.py

@@ -2,22 +2,27 @@
 """ This script converts the hold documentation (saved in markdown files) in a python file with a list of strings to translate it using gettext."""
 
 def prepare_documentation_in_file(fileSource, fileDest):
-	""" This takes documentation written in a markdown file and put all the contents in a python file, to create a internationalized documentation.
-	 @fileSource str: A markdown(.md) file.
-	 @fileDest str: A file where this will put the new strings"""
+    """ This takes documentation written in a markdown file and put all the contents in a python file, to create a translatable  documentation.
+        @fileSource str: A markdown(.md) file.
+        @fileDest str: A file where this will put the new strings"""
 
-	f1 = open(fileSource, "r")
-	f2 = open(fileDest, "w")
-	lns = f1.readlines()
-	f2.write("# -*- coding: utf-8 -*-\n")
-	f2.write("documentation = []\n")
-	for i in lns:
-		if len(i) > 2:
-			newvar = "documentation.append(_(u\"\"\"%s\"\"\"))\n" % (i[:-2])
-		else:
-			newvar = "documentation.append(_(u\"\"\"%s\"\"\"))\n" % (i)
-		f2.write(newvar)
-	f1.close()
-	f2.close()
+    f1 = open(fileSource, "r", encoding="utf-8")
+    f2 = open(fileDest, "w", encoding="utf-8")
+    lns = f1.readlines()
+    f2.write("# -*- coding: utf-8 -*-\n")
+    f2.write("documentation = [\n")
+    for i in lns:
+        if "\n" == i:
+            newvar = "\"\",\n"
+        elif "\n" == i[-1]:
+            newvar = "_(\"\"\"%s\"\"\"),\n" % (i[:-1])
+        else:
+            newvar = "_(\"\"\"%s\"\"\"),\n" % (i)
+        f2.write(newvar)
+    f1.close()
+    f2.write("]")
+    f2.close()
 
 
+prepare_documentation_in_file("manual.md", "strings.py")
+prepare_documentation_in_file("changelog.md", "changelog.py")

doc/generator.py

@@ -1,42 +1,87 @@
 # -*- coding: utf-8 -*-
-import markdown
+import gettext
 import os
-from codecs import open as _open
-import languageHandler
-languageHandler.setLanguage("en")
-import strings
+import locale
+import paths
+import markdown
+import shutil
+from importlib import reload
 
-# the list of supported language codes of TW Blue
-languages = ["en", "es", "fr", "de", "it", "gl", "ja", "ru", "ro"]
-#"eu", "ar", "ca", "es", "fi", "fr", "gl", "hu", "it", "pl", "pt", "ru", "tr"]
+# Languages already translated or translating the documentation.
+documentation_languages = ["en", "es", "fr", "de", "it", "gl", "ja", "ru", "ro", "eu", "ca", "da", "sr"]
 
-def generate_document(language):
- reload(languageHandler)
- languageHandler.setLanguage(language)
- reload(strings)
- markdown_file = markdown.markdown("\n".join(strings.documentation[1:]), extensions=["markdown.extensions.toc"])
- first_html_block = """<!doctype html>
- <html lang="%s">
- <head>
-  <title>%s</title>
-  <meta charset="utf-8">
-  </head>
-  <body>
-  <header><h1>%s</h1></header>
-  """ %  (language, strings.documentation[0], strings.documentation[0])
- first_html_block = first_html_block+ markdown_file
- first_html_block = first_html_block + "\n</body>\n</html>"
- if not os.path.exists(language):
-  os.mkdir(language)
- mdfile = _open("%s/manual.html" % language, "w", encoding="utf-8")
- mdfile.write(first_html_block)
- mdfile.close()
+
+# Changelog translated languages.
+changelog_languages = ["en", "ca", "de", "es", "eu", "fr", "gl", "ja", "ro", "ru", "sr"]
+
+# this function will help us to have both strings.py and changelog.py without issues by installing a global dummy translation function.
+def install_null_translation(name):
+    _ = gettext.NullTranslations()
+    _.install()
+    return
+
+def get_translations(name):
+    """ Create translation instances for every language of the translated document. """
+    translations = {}
+    if "documentation" in name:
+        langs = documentation_languages
+    else:
+        langs = changelog_languages
+    for l in langs:
+        if l != "en":
+            _ = gettext.translation(name, os.path.join(paths.app_path(), "locales"), languages=[l])
+            translations[l] = _
+        else:
+            _ = gettext.NullTranslations()
+            translations[l] = _
+    return translations
+
+def generate_document(lang, lang_name, document_type="documentation"):
+    """ Generates a document by using the provided lang object, which should be a translation, and lang_name, which should be the two letter code representing the language. """
+    if document_type == "documentation":
+        translation_file = "twblue-documentation"
+        markdown_file = markdown.markdown("\n".join([lang.gettext(s) if s != "" else s for s in strings.documentation[1:]]), extensions=["markdown.extensions.toc"])
+        title = lang.gettext(strings.documentation[0])
+        filename = "manual.html"
+    elif document_type == "changelog":
+        translation_file = "twblue-changelog"
+        markdown_file = markdown.markdown("\n".join([lang.gettext(s) if s != "" else s for s in changelog.documentation[1:]]), extensions=["markdown.extensions.toc"])
+        title = lang.gettext(changelog.documentation[0])
+        filename = "changelog.html"
+    first_html_block = """<!doctype html>
+    <html lang="%s">
+    <head>
+        <title>%s</title>
+        <meta charset="utf-8">
+        </head>
+        <body>
+        <header><h1>%s</h1></header>
+        """ %  (lang_name, title, title)
+    first_html_block = first_html_block+ markdown_file
+    first_html_block = first_html_block + "\n</body>\n</html>"
+    if not os.path.exists(os.path.join("documentation", lang_name)):
+        os.mkdir(os.path.join("documentation", lang_name))
+    mdfile = open(os.path.join("documentation", lang_name, filename), "w", encoding="utf-8")
+    mdfile.write(first_html_block)
+    mdfile.close()
 
 def create_documentation():
- print("Creating documentation in the supported languages...\n")
- for i in languages:
-  print("Creating documentation for: %s" % (i,))
-  generate_document(i)
- print("Done")
+    changelog_translations = get_translations("twblue-changelog")
+    documentation_translations = get_translations("twblue-documentation")
+    print("Creating documentation in the supported languages...\n")
+    if not os.path.exists("documentation"):
+        os.mkdir("documentation")
+    if os.path.exists(os.path.join("documentation", "license.txt")) == False:
+        shutil.copy(os.path.join("..", "license.txt"), os.path.join("documentation", "license.txt"))
+    for i in documentation_languages:
+        print("Creating documentation for: %s" % (i,))
+        generate_document(lang_name=i, lang=documentation_translations.get(i))
+    for i in changelog_languages:
+        print("Creating changelog  for: %s" % (i,))
+        generate_document(lang_name=i, lang=changelog_translations.get(i), document_type="changelog")
+    print("Done")
 
+install_null_translation("twblue-documentation")
+import strings
+import changelog
 create_documentation()

doc/languageHandler.py

@@ -1,176 +0,0 @@
-import __builtin__
-import os
-import sys
-import ctypes
-import locale
-import gettext
-#import paths
-import platform
-
-# A fix for the mac locales
-if platform.system() != 'Windows':
- if locale.getlocale()[0] is None:
-  locale.setlocale(locale.LC_ALL, 'en_US')
-
-#a few Windows locale constants
-LOCALE_SLANGUAGE=0x2
-LOCALE_SLANGDISPLAYNAME=0x6f
-
-curLang="en"
-
-def localeNameToWindowsLCID(localeName):
-	"""Retreave the Windows locale identifier (LCID) for the given locale name
-	@param localeName: a string of 2letterLanguage_2letterCountry or or just 2letterLanguage
-	@type localeName: string
-	@returns: a Windows LCID
-	@rtype: integer
-	""" 
-	#Windows Vista is able to convert locale names to LCIDs
-	func_LocaleNameToLCID=getattr(ctypes.windll.kernel32,'LocaleNameToLCID',None)
-	if func_LocaleNameToLCID is not None:
-		localeName=localeName.replace('_','-')
-		LCID=func_LocaleNameToLCID(unicode(localeName),0)
-	else: #Windows doesn't have this functionality, manually search Python's windows_locale dictionary for the LCID
-		localeName=locale.normalize(localeName)
-		if '.' in localeName:
-			localeName=localeName.split('.')[0]
-		LCList=[x[0] for x in locale.windows_locale.iteritems() if x[1]==localeName]
-		if len(LCList)>0:
-			LCID=LCList[0]
-		else:
-			LCID=0
-	return LCID
-
-def getLanguageDescription(language):
-	"""Finds out the description (localized full name) of a given local name"""
-	desc=None
-	if platform.system() == "Windows":
-		LCID=localeNameToWindowsLCID(language)
-		if LCID!=0:
-			buf=ctypes.create_unicode_buffer(1024)
-			if '_' not in language:
-				res=ctypes.windll.kernel32.GetLocaleInfoW(LCID,LOCALE_SLANGDISPLAYNAME,buf,1024)
-			else:
-				res=0
-			if res==0:
-				res=ctypes.windll.kernel32.GetLocaleInfoW(LCID,LOCALE_SLANGUAGE,buf,1024)
-			desc=buf.value
-	elif platform.system() == "Linux" or not desc:
-		desc={
-			"am":pgettext("languageName","Amharic"),
-			"an":pgettext("languageName","Aragonese"),
-			"es":pgettext("languageName","Spanish"),
-			"pt":pgettext("languageName","Portuguese"),
-			"ru":pgettext("languageName","Russian"),
-			"it":pgettext("languageName","italian"),
-			"tr":pgettext("languageName","Turkey"),
-			"gl":pgettext("languageName","Galician"),
-			"ca":pgettext("languageName","Catala"),
-			"eu":pgettext("languageName","Vasque"),
-			"pl":pgettext("languageName","polish"),
-			"ar":pgettext("languageName","Arabic"),
-			"ne":pgettext("languageName","Nepali"),
-			"sr":pgettext("languageName","Serbian (Latin)"),
-		}.get(language,None)
-	return desc
-
-def getAvailableLanguages():
-	"""generates a list of locale names, plus their full localized language and country names.
-	@rtype: list of tuples
-	"""
-	#Make a list of all the locales found in NVDA's locale dir
-	l=[x for x in os.listdir("locales") if not x.startswith('.')]
-	l=[x for x in l if os.path.isfile('locales/%s/LC_MESSAGES/twblue-documentation.mo' % x)]
-	#Make sure that en (english) is in the list as it may not have any locale files, but is default
-	if 'en' not in l:
-		l.append('en')
-		l.sort()
-	#For each locale, ask Windows for its human readable display name
-	d=[]
-	for i in l:
-		desc=getLanguageDescription(i)
-		label="%s, %s"%(desc,i) if desc else i
-		d.append(label)
-	#include a 'user default, windows' language, which just represents the default language for this user account
-	l.append("system")
-	# Translators: the label for the Windows default NVDA interface language.
-	d.append(_("User default"))
-	#return a zipped up version of both the lists (a list with tuples of locale,label)
-	return zip(l,d)
-
-def makePgettext(translations):
-	"""Obtaina  pgettext function for use with a gettext translations instance.
-	pgettext is used to support message contexts,
-	but Python 2.7's gettext module doesn't support this,
-	so NVDA must provide its own implementation.
-	"""
-	if isinstance(translations, gettext.GNUTranslations):
-		def pgettext(context, message):
-			message = unicode(message)
-			try:
-				# Look up the message with its context.
-				return translations._catalog[u"%s\x04%s" % (context, message)]
-			except KeyError:
-				return message
-	else:
-		def pgettext(context, message):
-			return unicode(message)
-	return pgettext
-
-def setLanguage(lang):
-	system = platform.system()
-	global curLang
-	try:
-		if lang=="system":
-			if system == "Windows":
-				windowsLCID=ctypes.windll.kernel32.GetUserDefaultUILanguage()
-				localeName=locale.windows_locale[windowsLCID]
-			else:
-				localeName=locale.getlocale()[0]
-			trans=gettext.translation('twblue-documentation', localedir="locales", languages=[localeName])
-			curLang=localeName
-		else:
-			trans=gettext.translation("twblue-documentation", localedir="locales", languages=[lang])
-			curLang=lang
-			localeChanged=False
-			#Try setting Python's locale to lang
-			try:
-				locale.setlocale(locale.LC_ALL, lang)
-				localeChanged=True
-			except:
-				pass
-			if not localeChanged and '_' in lang:
-				#Python couldn'tsupport the language_country locale, just try language.
-				try:
-					locale.setlocale(locale.LC_ALL, lang.split('_')[0])
-				except:
-					pass
-			#Set the windows locale for this thread (NVDA core) to this locale.
-			if system == "Windows":
-				LCID=localeNameToWindowsLCID(lang)
-				ctypes.windll.kernel32.SetThreadLocale(LCID)
-	except IOError:
-		trans=gettext.translation("twblue-documentation",fallback=True)
-		curLang="en"
-	trans.install(unicode=True)
-	# Install our pgettext function.
-	__builtin__.__dict__["pgettext"] = makePgettext(trans)
-
-def getLanguage():
-	return curLang
-
-def normalizeLanguage(lang):
-	"""
-	Normalizes a  language-dialect string  in to a standard form we can deal with.
-	Converts  any dash to underline, and makes sure that language is lowercase and dialect is upercase.
-	"""
-	lang=lang.replace('-','_')
-	ld=lang.split('_')
-	ld[0]=ld[0].lower()
-	#Filter out meta languages such as x-western
-	if ld[0]=='x':
-		return None
-	if len(ld)>=2:
-		ld[1]=ld[1].upper()
-	return "_".join(ld)
-

doc/manual.md

@@ -0,0 +1,361 @@
+Documentation for TWBlue
+
+## Table of contents
+
+[TOC]
+
+## Warning!
+
+You are reading documentation produced for a program still in development. The object of this manual is to explain some details of the operation of the program. Bear in mind that as the software is in the process of active development, parts of this user guide may change in the near future, so it is advisable to keep checking from time to time to avoid missing important information.
+
+If you want to see what has changed from the previous version, [read the list of updates here.](changes.html)
+
+## Introduction
+
+TWBlue is an application to make Twitter simple and fast, while using as few resources as possible. With TWBlue, you can do things like the following:
+
+* Tweet, reply to, retweet and delete tweets,
+* Like and unlike a tweet,
+* Send and delete direct messages,
+* See your friends and followers,
+* Follow, unfollow, report and block a user,
+* Open a user's timeline to see their tweets separately,
+* Open URLs from a tweet or direct message,
+* Play several types of audio files from addresses,
+* And more.
+
+## Usage
+
+Twitter is a social networking or micro-blogging tool which allows you to compose short status updates of your activities in 280 characters or less. Twitter is a way for friends, family and co-workers to communicate and stay connected through the exchange of quick, frequent messages. You can restrict delivery of updates to those in your circle of friends or, by default, allow anyone to access them.
+
+You can monitor the status of updates from your friends, family or co-workers (known as following), and they in turn can read any updates you create, (known as followers). The updates are referred to as Tweets. The Tweets are posted to your Twitter profile or Blog and are searchable using Twitter Search.
+
+In order to use TWBlue, you must first have created an account on the Twitter website. The process for signing up for a Twitter account is very accessible. During the account registration, you will need to choose a Twitter username. This serves two purposes. This is the method through which people will comunicate with you, but most importantly, your username and password will be required to connect TWBlue to your Twitter account. We suggest you choose a username which is memorable both to you and the people you hope will follow you.
+
+We'll start from the premise that you have a Twitter account with its corresponding username and password.
+
+### Authorising the application
+
+First of all, it's necessary to authorise the program so it can access your Twitter account and act on your behalf. The authorisation process is quite simple, and the program never retains data such as your password. In order to authorise the application, you just need to run the main executable file, called TWBlue.exe (on some computers it may appear simply as TWBlue if Windows Explorer is not set to display file extensions). We suggest you may like to place a Windows shortcut on your Desktop pointing to this executable file for quick and easy location.
+
+You can log into several Twitter accounts simultaneously. The program refers to each Twitter account you have configured as a "Session". If this is the first time you have launched TWBlue, and if no Twitter session exists, you will see the Session Manager. This dialogue box allows you to authorise as many accounts as you wish. If you press the Tab key to reach the "new account" button and activate it by pressing the Space Bar, a dialogue box will advise you that your default internet browser will be opened in order to authorise the application and you will be asked if you would like to continue. Activate the "yes" Button by pressing the letter "Y" so the process may start.
+
+Your default browser will open on the Twitter page to request authorisation. Enter your username and password into the appropriate edit fields if you're not already logged in, select the authorise button, and press it.
+
+Once you've authorised your twitter account, the website will redirect you to a page which will notify you that TWBlue has been authorised successfully. On this page, you will be shown a code composed of several numbers that you must paste in the TWBlue authorization dialogue in order to allow the application to access your account. Once you have pasted the code in the corresponding text field, press enter to finish the account setup and go back to the session manager. On the session list, you will see a new item temporarily called "Authorised account x" -where x is a number. The session name will change once you open that session.
+
+To start running TWBlue, press the Ok button in the Session Manager dialogue. By default, the program starts all the configured sessions automatically, however, you can change this behavior.
+
+If all went well, the application will start playing sounds, indicating your data is being updated.
+
+When the process is finished, by default the program will play another sound, and the screen reader will say "ready" (this behaviour can be configured).
+
+## General concepts
+
+Before starting to describe TWBlue's usage, we'll explain some concepts that will be used extensively throughout this manual.
+
+### Buffer
+
+A buffer is a list of items to manage the data which arrives from Twitter, after being processed by the application. When you configure a new session on TWBlue and start it, many buffers are created. Each of them may contain some of the items which this program works with: Tweets, direct messages, users, trends or. According to the buffer you are focusing, you will be able to do different actions with these items.
+
+The following is a description for every one of TWBlue's buffers and the kind of items they work with.
+
+* Home: this shows all the tweets on the main timeline. These are the tweets by users you follow.
+* Mentions: if a user, whether you follow them or not, mentions you on Twitter, you will find it in this list.
+* Direct messages: here you will find the private direct messages you exchange with users who follow you , or with any user, if you allow direct messages from everyone (this setting is configurable from Twitter). This list only shows received messages.
+* Sent direct messages: this buffer shows all the direct messages sent from your account.
+* Sent tweets: this shows all the tweets sent from your account.
+* Likes: here you will see all the tweets you have liked.
+* Followers: when users follow you, you'll be able to see them on this buffer, with some of their account details.
+* Friends: the same as the previous buffer, but these are the users you follow.
+* User timelines: these are buffers you may create. They contain only the tweets by a specific user. They're used so you can see the tweets by a single person and you don't want to look all over your timeline. You may create as many as you like.
+* Lists: A list is similar to a user timeline, except that you can configure it to contain tweets from multiple users.
+* Search: A search buffer contains the results of a search operation.
+* User likes: You can have the program create a buffer containing tweets liked by a particular user.
+* Followers or following timeline: You can have TWBlue create a buffer containing all users who follow, or are followed by a specific user.
+* Trending Topics: a trend buffer shows the top ten most used terms in a geographical region. This region may be a country or a city. Trends are updated every five minutes.
+
+If a tweet contains a URL, you can press enter in the GUI or Control + Windows + Enter in the invisible interface to open it. If it contains video or audio, including live stream content, you can press Control + Enter or Control + Windows + Alt + Enter to play it, respectively. TWBlue will play a sound if the tweet contains video metadata or the \#audio hashtag, but there may be tweets which contain media without this. Finally, if a tweet contains geographical information, you can press Control + Windows + G in the invisible interface to retrieve it.
+
+### Username fields
+
+These fields accept a Twitter username (without the at sign) as the input. They are present in the send direct message, the user actions dialogue and the user alias dialogue boxes, to name a few examples. Those dialogues will be discussed later. The initial value of these fields depends on where they were opened from. They are prepopulated with the username of the sender of the focused tweet (if they were opened from the home and sent timelines, from users' timelines or from lists), the sender of the focused direct message (if from the received or sent direct message buffers) or in the focused user (if from the followers' or friends' buffer). If one of those dialogue boxes is opened from a tweet, and if there are more users mentioned in it, you can use the arrow keys to switch between them. Alternatively, you can also type a username.
+
+## The program's interfaces
+
+### The graphical user interface (GUI)
+
+The graphical user interface of TWBlue consists of a window containing:
+
+* a menu bar accomodating six  menus (application, tweet, user, buffer, audio and help);
+* One tree view,
+* One list of items
+* Four buttons in most dialogs: Tweet, retweet , reply and direct message.
+
+The actions that are available for every item will be described later.
+
+In summary, the GUI contains two core components. These are the controls you will find while pressing the Tab key within the program's interface, and the different elements present on the menu bar.
+
+#### Buttons in the application
+
+* Tweet: this button opens up a dialogue box to write your tweet. Normal tweets must not exceed 280 characters. However you can press the long tweet checkbox and your tweet will be posted throught Twishort, wich will allow you to write longer tweets (10000 characters). If you write past this limit, a sound will play to warn you. Note that the character count is displayed in the title bar. You can upload a picture, check spelling, attach audio or translate your message by selecting one of the available buttons in the dialogue box. In addition, you can autocomplete the entering of users by pressing Alt + C or the button for that purpose if you have the database of users configured. Press enter to send the tweet. If all goes well, you'll hear a sound confirming it. Otherwise, the screen reader will speak an error message in English describing the problem.
+* Retweet: this button retweets the message you're reading. After you press it, if you haven't configured the application not to do so, you'll be asked if you want to add a comment or simply send it as written. If you choose to add a comment,  it will post a quoted tweet, that is,  the comment with a  link to the originating tweet.
+* Reply: when you're viewing a tweet, you can reply to the user who sent it by pressing this button. A dialogue will open up similar to the one for tweeting. If there are more users referred to in the tweet, you can press tab and activate the mention to all checkbox, or enabling checkbox for the users you want to mention separately. Note, however, that sometimes -especially when replying to a retweet or quoted tweet, the user who made the retweet or quote may also be mentioned. This is done by Twitter automatically. When you're on the friends or followers lists, the button will be called mention instead.
+* Direct message: exactly like sending a tweet, but it's a private message which can only be read by the user you send it to. Press shift-tab twice to see the recipient. If there were other users mentioned in the tweet you were reading, you can arrow up or down to choose which one to send it to, or write the username yourself without the at sign. In addition, you can autocomplete the entering of users by pressing Alt + C or the button for that purpose if you have the database of users configured.
+
+Bear in mind that buttons will appear according to which actions are possible on the list you are browsing. For example, on the home timeline, mentions, sent, likes and user timelines you will see the four buttons, while on the direct messages list you'll only get the direct message and tweet buttons, and on friends and followers lists the direct message, tweet, and mention buttons will be available.
+
+#### Menus
+
+Visually, Towards the top of the main application window, can be found a menu bar which contains many of the same functions as listed in the previous section, together with some additional items. To access the menu bar, press the alt key. You will find six menus listed: application, tweet, user, buffer, audio and help. This section describes the items on each one of them.
+
+##### Application menu
+
+* Manage accounts: Opens a window with all the sessions configured in TWBlue, where you can add new sessions or delete the ones you've already created.
+* Update profile: opens a dialogue where you can update your information on Twitter: name, location, website and bio. If you have already set this up the fields will be prefilled with the existing information. Also, you can upload a photo to your profile.
+* Hide window: turns off the Graphical User Interface. Read the section on the invisible interface for further details.
+* Search: shows a dialogue box where you can search for tweets or users on Twitter.
+* Lists Manager: This dialogue box allows you to manage your Twitter lists. In order to use them, you must first create them. Here, you can view, edit, create, delete or, optionally, open them in buffers similar to user timelines.
+* Manage user aliases: Opens up a dialogue where you can manage user aliases for the active session. In this dialog you can add new aliases, as well as edit and delete existing ones.
+* Edit keystrokes: this opens a dialogue where you can see and edit the shortcuts used in the invisible interface.
+* Account settings: Opens a dialogue box which lets you customize settings for the current account.
+* Global settings: Opens a dialogue which lets you configure settings for the entire application.
+* Exit: asks whether you want to exit the program. If the answer is yes, it closes the application. If you do not want to be asked for confirmation before exiting, uncheck the checkbox from the global settings dialogue box.
+
+##### Tweet menu
+
+* You will first find the items to tweet, reply and retweet, which are equivalent to the buttons with the same name.
+* Like: Adds the tweet you're viewing to your likes list.
+* Unlike: removes the tweet from your likes, but not from Twitter.
+* Show tweet: opens up a dialogue box where you can read the tweet, direct message, friend or follower which has focus. You can read the text with the arrow keys. It's a similar dialog box as used for composing tweets, without the ability to send the tweet, file attachment and autocompleting capabilities. It does however include a retweets and likes count. If you are in the followers or the friends list, it will only contain a read-only edit box with the information in the focused item and a close button.
+* View address: If the selected tweet has geographical information, TWBlue may display a dialogue box where you can read the tweet address. This address is retrieved by sending the geographical coordinates of the tweet to Google maps.
+* View conversation: If you are focusing a tweet with a mention, it opens a buffer where you can view the whole conversation.
+* Read text in pictures: Attempt to apply OCR technology to the image attached to the tweet. The result will be displayed in another dialog.
+* Delete: permanently removes the tweet or direct message which has focus from Twitter and from your lists. Bear in mind that Twitter only allows you to delete tweets you have posted yourself.
+
+##### User menu
+
+* Actions: Opens a dialogue where you can interact with a user. This dialogue box will be populated with the user who sent the tweet or direct message in focus or the selected user in the friends or followers buffer. You can edit it or leave it as is and choose one of the following actions:
+ * Follow: Follows a user. This means you'll see his/her tweets on your home timeline, and if he/she also follows you, you'll be able to exchange direct messages. You may also send / receive direct messages from each other if you have configured the option to allow direct messages from anyone.
+ * Unfollow: Stops following a user, which causes you not being able to see his/her tweets on your main timeline neither exchanging direct messages, unless they have enabled receiving direct messages from anyone.
+ * Mute: While muting someone, TWBlue won't show you nor his/her tweets on your main timeline; neither will you see that person's mentions. But you both will be able to exchange direct messages. The muted user is not informed of this action.
+ * Unmute: this option allows TWBlue to display the user's tweets and mentions again.
+ * Block: Blocks a user. This forces the user to unfollow you .
+ * Unblock: Stops blocking a user.
+ * Report as spam: this option sends a message to Twitter suggesting the user is performing prohibited practices on the social network.
+ * Ignore tweets from this client: Adds the client from which the focused tweet was sent to the ignored clients list.
+* View timeline: Lets you open a user's timeline by choosing the user in a dialog box. It is created when you press enter. If you invoke this option relative to a user that has no tweets, the operation will fail. If you try creating an existing timeline the program will warn you and will not create it again.
+* Direct message: same action as the button.
+* Add Alias: An user alias allows you to rename user's display names on Twitter, so the next time you'll read an user it will be announced as you configured. This feature works only if you have set display screen names unchecked, in account settings.
+* Add to List: In order to see someone's tweets in one or more of your lists, you must add them first. In the dialogue box that opens after selecting the user, you will be asked to select the list you wish to add the user to. Thereafter, the list will contain a new member and their tweets will be displayed there.
+* Remove from list: lets you remove a user from a list.
+* View lists: Shows the lists created by a specified user.
+* Show user profile: opens a dialogue with the profile of the specified user.
+* View likes: Opens a buffer where you can see the tweets which have been liked by a particular user.
+
+##### Buffer menu
+
+* Update buffer: Retrieves the newest items for the focused buffer. Normally, every buffer gets updated every couple of minutes, however you can force a specific buffer to be updated inmediately. Take into account, however, that the usage of this option repeatedly might exceed your allowed Twitter's API usage, in which case you would have to wait until it gets reset, tipycally within the next 15 minutes.
+* New trending topics buffer: This opens a buffer to get the worlwide trending topics or those of a country or a city. You'll be able to select from a dialogue box if you wish to retrieve countries' trends, cities' trends or worldwide trends (this option is in the cities' list) and choose one from the selected list. The trending topics buffer will be created once the "OK" button has been activated within the dialogue box. Remember this kind of buffer will be updated every five minutes.
+* Load previous items: This allows more items to be loaded for the specified buffer.
+* Create filter: Creates a filter in the current buffer. Filters allow loading or ignoring tweets that meet certain conditions into a buffer. You can, for example, set a filter in the "home" buffer that loads tweets that are in English language only. By default, the filter creation dialog will place the focus on the field to name the filter. Currently, you can filter by word, by language, or both. In the filter by word, you can make TWBlue allow or ignore tweets with the desired word. In the filter by language, you can make the program load tweets in the languages you want, or ignore tweets written in certain languages. Once created, every filter will be saved in the session config and will be kept across application restarts.
+* Manage filters: Opens up a dialogue which allows you to delete filters for the current session.
+* Find a string in the currently focused buffer: Opens a dialogue where you can search for items in the current buffer.
+* Mute: Mutes notifications of a particular buffer so you will not hear when new tweets arrive.
+* autoread: When enabled, the screen reader or SAPI 5 Text to Speech voice (if enabled) will read the text of incoming tweets. Please note that this could get rather chatty if there are a lot of incoming tweets.
+* Clear buffer: Deletes all items from the buffer.
+* Destroy: dismisses the list you're on.
+
+##### Audio menu
+
+* Play/pause: try to play audio for the selected item (if available), or stop the currently played audio.
+* Seek back 5 seconds: If an audio is being played, seek 5 seconds back in the playback. This will work only in audio files. This feature cannot be used in radio stations or other streamed files.
+* Seek forward 5 seconds: If an audio is being played, seek 5 seconds forward  in the playback. This feature cannot be used in radio stations or other streamed files.
+
+##### Help menu
+
+* Documentation: opens up this file, where you can read some useful program concepts.
+* Sounds tutorial: Opens a dialog box where you can familiarize yourself with the different sounds of the program.
+* What's new in this version?: opens up a document with the list of changes from the current version to the earliest.
+* Check for updates: every time you open the program it automatically checks for new versions. If an update is available, it will ask you if you want to download the update. If you accept, the updating process will commence. When complete, TWBlue will be restarted. This item checks for new updates without having to restart the application.
+* TWBlue's website: visit our [home page](http://twblue.es) where you can find all relevant information and downloads for TWBlue and become a part of the community.
+* Get soundpacks for TWBlue: 
+* Make a Donation: Opens a website from which you can donate to the TWBlue project. Donations are made through paypal and you don't need an account to donate.
+* About TWBlue: shows the credits of the program.
+
+### The invisible user interface
+
+The invisible interface, as its name suggests, has no graphical window and works directly with screen readers such as JAWS for Windows, NVDA and System Access. This interface is disabled by default, but you can enable it by pressing Control + M. It works similarly to TheQube and Chicken Nugget. Its shortcuts are similar to those found in these two clients. In addition, the program has builtin support for the keymaps for these applications, configurable through the global settings dialogue. By default, you cannot use this interface's shortcuts in the GUI, but you can configure this in the global settings dialogue.
+
+The next section contains a list of keyboard shortcuts for both interfaces. Bear in mind that we will only describe the default keymap.
+
+## Keyboard shortcuts
+
+### Shortcuts of the graphical user interface (GUI)
+
+* Enter: Open URL.
+* Control + Enter: Play audio.
+* Control + M: Hide the GUI.
+* Control + N: Compose a new tweet.
+* Control + R: Reply / mention.
+* Control + Shift + R: Retweet.
+* Control + D: Send a direct message.
+* control + F: Add tweet to likes.
+* Control + Shift + F: Remove a tweet from likes.
+* Control + S: Open the user actions dialogue.
+* Control + Shift + V: Show tweet.
+* Control + Q: Quit this program.
+* Control + I: Open user timeline.
+* Control + Shift + i: Destroy buffer.
+* F5: Increase volume by 5%.
+* F6: Decrease volume by 5%.
+* Control + P: Edit your profile.
+* Control + Delete: Delete a tweet or direct message.
+* Control + Shift + Delete: Empty the current buffer.
+
+### Shortcuts of the invisible interface (default keymap)
+
+The invisible interface of TWBlue can be customised by using a keymap. Every keymap defines a set of keystrokes to be used along with the invisible interface. You can change the keymap in the global settings dialogue, under the application menu in the menu bar, and check or edit keystrokes for the selected keymap in the keystroke editor, also available in the application menu.
+
+* Control + Windows + Up Arrow: moves to the previous item in the buffer.
+* Control + Windows + Down Arrow: moves to the next item in the buffer.
+* Control + Windows + Left Arrow: Move to the previous buffer.
+* Control + Windows + Right Arrow: Move to the next buffer.
+* Control + Windows + Shift + Left: Focus the previous session.
+* Control + Windows + Shift + Right: Focus the next session.
+* Control + Windows + C: View conversation.
+* Control + Windows + Enter: Open URL.
+* Control + Windows + ALT + Enter: Play audio.
+* Control + Windows + M: Show or hide the GUI.
+* Control + Windows + N: New tweet.
+* Control + Windows + R: Reply / Mention.
+* Control + Windows + Shift + R: Retweet.
+* Control + Windows + D: Send direct message.
+* Windows+ Alt + F: Like a tweet.
+* Alt + Windows + Shift + F: Remove from likes.
+* Control + Windows + S: Open the user actions dialogue.
+* Control + Windows + Alt + N: See user details.
+* Control + Windows + V: Show tweet.
+* Control + Windows + F4: Quit TWBlue.
+* Control + Windows + I: Open user timeline.
+* Control + Windows + Shift + I: Destroy buffer.
+* Control + Windows + Alt + Up: Increase volume by 5%.
+* Control + Windows + Alt + Down: Decrease volume by 5%.
+* Control + Windows + Home: Jump to the first element of the current buffer.
+* Control + Windows + End: Jump to the last element of the current buffer.
+* Control + Windows + PageUp: Jump 20 elements up in the current buffer.
+* Control + Windows + PageDown: Jump 20 elements down in the current buffer.
+* Windows + Alt + P: Edit profile.
+* Control + Windows + Delete: Delete a tweet or direct message.
+* Control + Windows + Shift + Delete: Empty the current buffer.
+* Control + Windows + Space: Repeat last item.
+* Control + Windows + Shift + C: Copy to clipboard.
+* Control + Windows+ A: Add user to list.
+* Control + Windows + Shift + A: Remove user from list.
+* Control + Windows + Shift + M: Mute / unmute the current buffer.
+* Windows + Alt + M: Mute / unmute the current session.
+* Control + Windows + E: Toggle the automatic reading of incoming tweets in the current buffer.
+* Control + Windows + -: Search on Twitter.
+* Control + Windows + K: Show the keystroke editor.
+* Control + Windows + L: Show lists for a specified user.
+* Windows + Alt + PageUp: Load previous items for the current buffer.
+* Control + Windows + G: Get geolocation.
+* Control + Windows + Shift + G: Display the tweet's geolocation in a dialogue.
+* Control + Windows + T: Create a trending topics' buffer.
+* Control + Windows + {: Find a string in the current buffer.
+* Alt + Windows + O: Extracts text from the picture and display the result in a dialog.
+
+## Configuration
+
+As described above, this application has two configuration dialogues, the global settings dialogue and the account settings dialogue.
+
+### The account settings dialogue
+
+#### General tab
+
+* Autocompletion settings: Allows you to configure the autocompletion database. You can add users manually or let TWBlue add your followers, friends or both.
+* Relative timestamps: Allows you to configure whether the application will calculate the time the tweet or direct message was sent or received based on the current time, or simply say the time it was received or sent.
+* API calls: Allows you to adjust the number of API calls to be made to Twitter by this program.
+* Items on each API call: Allows you to specify how many items should be retrieved from Twitter for each API call (default and maximum is 200).
+* Inverted buffers: Allows you to specify whether the buffers should be inverted, which means that the oldest items will show at the end of them and the newest at the beginning.
+* Retweet mode: Allows you to specify the behaviour when posting a retweet: you can choose between retweeting with a comment, retweeting without comment or being asked.
+* Number of items per buffer to cache in database: This allows you to specify how many items TWBlue should cache in a database. You can type any number, 0 to cache all items, or leave blank to disable caching entirely.
+
+#### buffers tab
+
+This tab displays a list for each buffer you have available in TWBlue, except for searches, timelines, likes' timelines and lists. You can show, hide and move them.
+
+#### The ignored clients tab
+
+In this tab, you can add and remove clients to be ignored by the program.
+
+#### Sound tab
+
+In this tab, you can adjust the sound volume, select the input and output device and set the soundpack used by the program.
+
+#### Audio service tab
+
+In this tab, you can enter your SndUp API key (if you have one) to upload audio to SndUp with your account. Note that if account credentials are not specified you will upload anonimously.
+
+### Global settings
+
+This dialogue allows you to configure some settings which will affect the entire application.
+
+#### General tab {#general-tab_1}
+
+* Language: This allows you to change the language of this program. Currently supported languages are arabic, Catalan, German, English, Spanish, Basque, Finnish, French, Galician, Croatian, Hungarian, Italian, Polish, Portuguese, Russian and Turkish.
+* Ask before exiting TWBlue: This checkbox allows you to control whetherthe program will ask for confirmation before exiting.
+* Play a sound when TWBlue launches: This checkbox allows you to configure whether the application will play a sound when it has finished loading the buffers.
+* Speak a message when TWBlue launches: This is the same as the previous option, but this checkbox configures whether the screen reader will say "ready".
+* Use the invisible interface's shortcuts in the GUI: As the invisible interface and the Graphical User Interface have their own shortcuts, you may want to use the invisible interface's keystrokes all the time. If this option is checked, the invisible interface's shortcuts will be usable in the GUI.
+* Activate SAPI5 when any other screen reader is not being run: This checkbox allows to activate SAPI 5 TTS when no other screen reader is being run.
+* Hide GUI on launch: This allows you to configure whether TWBlue will start with the GUI or the invisible interface.
+* Keymap: This option allows you to change the keymap used by the program in the invisible interface. The shipped keymaps are Default, Qwitter, Windows 10 and Chicken Nugget. The keymaps are in the "keymaps" folder, and you can create new ones. Just create a new ".keymap" file and change the keystrokes associated with the actions, as it is done in the shipped keymaps.
+
+#### Proxi tab
+
+In this tab you can configure TWBlue to use a Proxy server by completing the fields displayed (type, server, port, user and password).
+
+## License, source code and donations
+
+Tw Blue is free software, licensed under the GNU GPL license, either version 2 or, at your option, any later version. You can view the license in the file named license.txt, or online at <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>.
+
+The source code of the program is available on GitHub at <https://www.github.com/manuelcortez/twblue>.
+
+If you want to donate to the project, you can do so at <https://twblue.es/donate>. Thank you for your support!
+
+## Contact
+
+If you still have questions after reading this document, if you wish to collaborate to the project in some other way, or if you simply want to get in touch with the application developer, follow the Twitter account [@tw\_blue2](https://twitter.com/tw_blue2) or [@manuelcortez00.](https://twitter.com/manuelcortez00) You can also visit [our website](https://twblue.es)
+
+## Credits
+
+TWBlue is developed and maintained by [Manuel Cortéz](https://twitter.com/manuelcortez00) and [José Manuel Delicado](https://twitter.com/jmdaweb).
+
+We would also like to thank the translators of TWBlue, who have allowed the spreading of the application.
+
+* Arabic: [Mohammed Al Shara,](https://twitter.com/mohammed0204) [Hatoun Felemban](https://twitter.com/HatounFelemban)
+* Basque: [Sukil Etxenike](https://twitter.com/sukil2011).
+* Catalan: [Francisco Torres](https://twitter.com/ftgalleg)
+* Croatian: [Zvonimir Stanečić](https://twitter.com/zvonimirek222).
+* English: [Manuel Cortéz](https://twitter.com/manuelcortez00).
+* Finnish: [Jani Kinnunen](https://twitter.com/jani_kinnunen).
+* French: [Rémy Ruiz](https://twitter.com/blindhelp38).
+* Galician: [Juan Buño](https://twitter.com/Quetzatl_).
+* German: [Steffen Schultz](https://twitter.com/schulle4u).
+* Hungarian: Robert Osztolykan.
+* Italian: [Christian Leo Mameli](https://twitter.com/llajta2012).
+* Japanese: [Riku](https://twitter.com/_riku02)
+* Polish: [Pawel Masarczyk.](https://twitter.com/Piciok)
+* Portuguese: [Odenilton Júnior Santos.](https://twitter.com/romaleif)
+* Romanian: [Florian Ionașcu](https://twitter.com/florianionascu7) and [Nicușor Untilă](https://twitter.com/dj_storm2001)
+* Russian: [Наталья Хедлунд](https://twitter.com/Lifestar_n) and [Валерия Кузнецова](https://twitter.com/ValeriaK305).
+* Serbian: [Aleksandar Đurić](https://twitter.com/sokodtreshnje)
+* Spanish: [Manuel Cortéz](https://twitter.com/manuelcortez00).
+* Turkish: [Burak Yüksek](https://twitter.com/burakyuksek).
+
+Many thanks also to the people who worked on the documentation. Initially, [Manuel Cortez](https://twitter.com/manuelcortez00) did the documentation in Spanish, and translated to English by [Bryner Villalobos](https://twitter.com/Bry_StarkCR), [Robert Spangler](https://twitter.com/glasscity1837), [Sussan Rey](https://twitter.com/sussanrey17), [Anibal Hernandez](https://twitter.com/AnimalMetal), and [Holly Scott-Gardner](https://twitter.com/CatchTheseWords). It was updated by [Sukil Etxenike](https://twitter.com/sukil2011), with some valuable corrections by [Brian Hartgen](https://twitter.com/brianhartgen) and [Bill Dengler](https://twitter.com/codeofdusk).
+
+------------------------------------------------------------------------
+
+Copyright © 2013-2021. Manuel Cortéz

doc/paths.py

@@ -0,0 +1,67 @@
+# -*- coding: utf-8 -*-
+import sys
+import platform
+import os
+import glob
+from platform_utils import paths as paths_
+
+mode = "portable"
+directory = None
+fsencoding = sys.getfilesystemencoding()
+
+if len(glob.glob("Uninstall.exe")) > 0: # installed copy
+	mode= "installed"
+
+def app_path():
+	return paths_.app_path()
+
+def config_path():
+	global mode, directory
+	if mode == "portable":
+		if directory != None: path = os.path.join(directory, "config")
+		elif directory == None: path = os.path.join(app_path(), "config")
+	elif mode == "installed":
+		path = os.path.join(data_path(), "config")
+	if not os.path.exists(path):
+#		log.debug("%s path does not exist, creating..." % (path,))
+		os.mkdir(path)
+	return path
+
+def logs_path():
+	global mode, directory
+	if mode == "portable":
+		if directory != None: path = os.path.join(directory, "logs")
+		elif directory == None: path = os.path.join(app_path(), "logs")
+	elif mode == "installed":
+		path = os.path.join(data_path(), "logs")
+	if not os.path.exists(path):
+#		log.debug("%s path does not exist, creating..." % (path,))
+		os.mkdir(path)
+	return path
+
+def data_path(app_name='socializer'):
+	if platform.system() == "Windows":
+		data_path = os.path.join(os.getenv("AppData"), app_name)
+	else:
+		data_path = os.path.join(os.environ['HOME'], ".%s" % app_name)
+	if not os.path.exists(data_path):
+		os.mkdir(data_path)
+	return data_path
+
+def locale_path():
+	return os.path.join(app_path(), "locales")
+
+def sound_path():
+	return os.path.join(app_path(), "sounds")
+
+def com_path():
+	global mode, directory
+	if mode == "portable":
+		if directory != None: path = os.path.join(directory, "com_cache")
+		elif directory == None: path = os.path.join(app_path(), "com_cache")
+	elif mode == "installed":
+		path = os.path.join(data_path(), "com_cache")
+	if not os.path.exists(path):
+#		log.debug("%s path does not exist, creating..." % (path,))
+		os.mkdir(path)
+	return path

doc/strings.py

@@ -1,432 +0,0 @@
-# -*- coding: utf-8 -*-
-import application
-documentation = []
-documentation.append(_(u"""Documentation for TWBlue - {0}""").format(application.version))
-# Translators: This is the new line character, don't change it in the translations.
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Table of contents"""))
-# Table of contents for the python markdown extension
-documentation.append("""[TOC]""")
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Warning!"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""You are reading documentation produced for a program still in development. The object of this manual is to explain some details of the operation of the program. Bear in mind that as the software is in the process of active development, parts of this user guide may change in the near future, so it is advisable to keep checking from time to time to avoid missing important information."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""If you want to see what has changed from the previous version, [read the list of updates here.](changes.html)"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Introduction"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""TWBlue is an application to make Twitter simple and fast, while using as few resources as possible. With TWBlue, you can do things like the following:"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Tweet, reply to, retweet and delete tweets,"""))
-documentation.append(_(u"""* Mark and unmark a tweet as favourite,"""))
-documentation.append(_(u"""* Send and delete direct messages,"""))
-documentation.append(_(u"""* See your friends and followers,"""))
-documentation.append(_(u"""* Follow, unfollow, report and block a user,"""))
-documentation.append(_(u"""* Open a user's timeline to see their tweets separately,"""))
-documentation.append(_(u"""* Open URLs from a tweet or direct message,"""))
-documentation.append(_(u"""* Play several types of audio files from addresses,"""))
-documentation.append(_(u"""* And more."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Usage"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Twitter is a social networking or micro-blogging tool which allows you to compose short status updates of your activities in 140 characters or less. Twitter is a way for friends, family and co-workers to communicate and stay connected through the exchange of quick, frequent messages. You can restrict delivery of updates to those in your circle of friends or, by default, allow anyone to access them."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""You can monitor the status of updates from your friends, family or co-workers (known as following), and they in turn can read any updates you create, (known as followers). The updates are referred to as Tweets. The Tweets are posted to your Twitter profile or Blog and are searchable using Twitter Search."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""In order to use TWBlue, you must first have created an account on the Twitter website. The process for signing up for a Twitter account is very accessible. During the account registration, you will need to choose a Twitter username. This serves two purposes. This is the method through which people will comunicate with you, but most importantly, your username and password will be required to connect TWBlue to your Twitter account. We suggest you choose a username which is memorable both to you and the people you hope will follow you."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""We'll start from the premise that you have a Twitter account with its corresponding username and password."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### Authorising the application"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""First of all, it's necessary to authorise the program so it can access your Twitter account and act on your behalf. The authorisation process is quite simple, and the program never retains data such as your password. In order to authorise the application, you just need to run the main executable file, called TWBlue.exe (on some computers it may appear simply as TWBlue if Windows Explorer is not set to display file extensions). We suggest you may like to place a Windows shortcut on your Desktop pointing to this executable file for quick and easy location."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""You can log into several Twitter accounts simultaneously. The program refers to each Twitter account you have configured as a "Session". If this is the first time you have launched TWBlue, and if no Twitter session exists, you will see the Session Manager. This dialogue box allows you to authorise as many accounts as you wish. If you press the Tab key to reach the "new account" button and activate it by pressing the Space Bar, a dialogue box will advise you that your default internet browser will be opened in order to authorise the application and you will be asked if you would like to continue. Activate the "yes" Button by pressing the letter "Y" so the process may start."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Your default browser will open on the Twitter page to request authorisation. Enter your username and password into the appropriate edit fields if you're not already logged in, select the authorise button, and press it."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Once you've authorised your twitter account, the website will redirect you to a page which will notify you that TWBlue has been authorised successfully. Now you are able to close the page by pressing ALT+F4 which will return you to the Session Manager. On the session list, you will see a new item temporarily called "Authorised account x" -where x is a number. The session name will change once you open that session."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""To start running TWBlue, press the Ok button in the Session Manager dialogue. By default, the program starts all the configured sessions automatically, however, you can change this behavior."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""If all went well, the application will start playing sounds, indicating your data is being updated."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""When the process is finished, by default the program will play another sound, and the screen reader will say "ready" (this behaviour can be configured)."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## General concepts"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Before starting to describe TWBlue's usage, we'll explain some concepts that will be used extensively throughout this manual."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### Buffer"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""A buffer is a list of items to manage the data which arrives from Twitter, after being processed by the application. When you configure a new session on TWBlue and start it, many buffers are created. Each of them may contain some of the items which this program works with: Tweets, direct messages, users, trends or events. According to the buffer you are focusing, you will be able to do different actions with these items."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""The following is a description for every one of TWBlue's buffers and the kind of items they work with."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Home: this shows all the tweets on the main timeline. These are the tweets by users you follow."""))
-documentation.append(_(u"""* Mentions: if a user, whether you follow them or not, mentions you on Twitter, you will find it in this list."""))
-documentation.append(_(u"""* Direct messages: here you will find the private direct messages you exchange with users who follow you , or with any user, if you allow direct messages from everyone (this setting is configurable from Twitter). This list only shows received messages."""))
-documentation.append(_(u"""* Sent direct messages: this buffer shows all the direct messages sent from your account."""))
-documentation.append(_(u"""* Sent tweets: this shows all the tweets sent from your account."""))
-documentation.append(_(u"""* Favourites: here you will see all the tweets you have favourited."""))
-documentation.append(_(u"""* Followers: when users follow you, you'll be able to see them on this buffer, with some of their account details."""))
-documentation.append(_(u"""* Friends: the same as the previous buffer, but these are the users you follow."""))
-documentation.append(_(u"""* User timelines: these are buffers you may create. They contain only the tweets by a specific user. They're used so you can see the tweets by a single person and you don't want to look all over your timeline. You may create as many as you like."""))
-documentation.append(_(u"""* Events: An event is anything that happens on Twitter, such as when someone follows you, when someone adds or removes one of your tweets from their favourites list, or when you subscribe to a list. There are many more, but the program shows the most common ones in the events buffer so that you can easily keep track of what is happening on your account."""))
-documentation.append(_(u"""* Lists: A list is similar to a user timeline, except that you can configure it to contain tweets from multiple users."""))
-documentation.append(_(u"""* Search: A search buffer contains the results of a search operation."""))
-documentation.append(_(u"""* User favourites: You can have the program create a buffer containing tweets favourited by a particular user."""))
-documentation.append(_(u"""* Trending Topics: a trend buffer shows the top ten most used terms in a geographical region. This region may be a country or a city. Trends are updated every five minutes."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""If a tweet contains a URL, you can press enter in the GUI or Control + Windows + Enter in the invisible interface to open it. If it contains audio, you can press Control + Enter or Control + Windows + Alt + Enter to play it, respectively. TWBlue will play a sound if the tweet contains the #audio hashtag, but there may be tweets which contain audio without this. Finally, if a tweet contains geographical information, you can press Control + Windows + G in the invisible interface to retrieve it."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### Username fields"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""These fields accept a Twitter username (without the at sign) as the input. They are present in the send direct message and the user actions dialogue boxes. Those dialogues will be discussed later. The initial value of these fields depends on where they were opened from. They are prepopulated with the username of the sender of the focused tweet (if they were opened from the home and sent timelines, from users' timelines or from lists), the sender of the focused direct message (if from the received or sent direct message buffers) or in the focused user (if from the followers' or friends' buffer). If one of those dialogue boxes is opened from a tweet, and if there are more users mentioned in it, you can use the arrow keys to switch between them. Alternatively, you can also type a username."""))
-documentation.append(_(u"""## The program's interfaces"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### The graphical user interface (GUI)"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""The graphical user interface of TWBlue consists of a window containing:"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* a menu bar accomodating five menus (application, tweet, user, buffer and help);"""))
-documentation.append(_(u"""* One tree view,"""))
-documentation.append(_(u"""* One list of items"""))
-documentation.append(_(u"""* Four buttons in most dialogs: Tweet, retweet , reply and direct message."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""The actions that are available for every item will be described later."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""In summary, the GUI contains two core components. These are the controls you will find while pressing the Tab key within the program's interface, and the different elements present on the menu bar."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### Buttons in the application"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Tweet: this button opens up a dialogue box to write your tweet. The message must not exceed 140 characters. If you write past this limit, a sound will play to warn you. Note that the character count is displayed in the title bar. You may use the shorten and expand URL buttons to comply with the character limit. You can upload a picture, check spelling, attach audio or translate your message by selecting one of the available buttons in the dialogue box. In addition, you can autocomplete the entering of users by pressing Alt + A or the button for that purpose if you have the database of users configured. Press enter to send the tweet. If all goes well, you'll hear a sound confirming it. Otherwise, the screen reader will speak an error message in English describing the problem."""))
-documentation.append(_(u"""* Retweet: this button retweets the message you're reading. After you press it, if you haven't configured the application not to do so, you'll be asked if you want to add a comment or simply send it as written. If you choose to add a comment, and if the original tweet plus the comment exceeds 140 characters, you will be asked if you want to post it as a comment with a mention to the original user and a link to the originating tweet."""))
-documentation.append(_(u"""* Reply: when you're viewing a tweet, you can reply to the user who sent it by pressing this button. A dialogue will open up similar to the one for tweeting, but with the name of the user already filled in (for example @user) so you only need to write your message. If there are more users referred to in the tweet, you can press shift-tab and activate the mention all users button. When you're on the friends or followers lists, the button will be called mention instead."""))
-documentation.append(_(u"""* Direct message: exactly like sending a tweet, but it's a private message which can only be read by the user you send it to. Press shift-tab to see the recipient. If there were other users mentioned in the tweet you were reading, you can arrow up or down to choose which one to send it to, or write the username yourself without the at sign."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Bear in mind that buttons will appear according to which actions are possible on the list you are browsing. For example, on the home timeline, mentions, sent, favourites and user timelines you will see the four buttons, while on the direct messages list you'll only get the direct message and tweet buttons, and on friends and followers lists the direct message, tweet, and mention buttons will be available."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### Menus"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Visually, Towards the top of the main application window, can be found a menu bar which contains many of the same functions as listed in the previous section, together with some additional items. To access the menu bar, press the alt key. You will find five menus listed: application, tweet, user, buffer and help. This section describes the items on each one of them."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""##### Application menu"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Manage accounts: Opens a window with all the sessions configured in TWBlue, where you can add new sessions or delete the ones you've already created."""))
-documentation.append(_(u"""* Update profile: opens a dialogue where you can update your information on Twitter: name, location, website and bio. If you have already set this up the fields will be prefilled with the existing information. Also, you can upload a photo to your profile."""))
-documentation.append(_(u"""* Hide window: turns off the Graphical User Interface. Read the section on the invisible interface for further details."""))
-documentation.append(_(u"""* Search: shows a dialogue box where you can search for tweets or users on Twitter."""))
-documentation.append(_(u"""* Lists Manager: This dialogue box allows you to manage your Twitter lists. In order to use them, you must first create them. Here, you can view, edit, create, delete or, optionally, open them in buffers similar to user timelines."""))
-documentation.append(_(u"""* Edit keystrokes: this opens a dialogue where you can see and edit the shortcuts used in the invisible interface."""))
-documentation.append(_(u"""* Account settings: Opens a dialogue box which lets you customize settings for the current account."""))
-documentation.append(_(u"""* Global settings: Opens a dialogue which lets you configure settings for the entire application."""))
-documentation.append(_(u"""* Exit: asks whether you want to exit the program. If the answer is yes, it closes the application. If you do not want to be asked for confirmation before exiting, uncheck the checkbox from the global settings dialogue box."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""##### Tweet menu"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* You will first find the items to tweet, reply and retweet, which are equivalent to the buttons with the same name."""))
-documentation.append(_(u"""* Add to favourites: marks the tweet you're viewing as a favourite."""))
-documentation.append(_(u"""* Remove from favourites: removes the tweet from your favourites, but not from Twitter."""))
-documentation.append(_(u"""* Show tweet: opens up a dialogue box where you can read the tweet, direct message, friend or follower which has focus. You can read the text with the arrow keys. It's a similar dialog box as used for composing tweets, without the ability to send the tweet, file attachment and autocompleting capabilities. It does however include a retweets and favourites count. If you are in the followers or the friends list, it will only contain a read-only edit box with the information in the focused item and a close button."""))
-documentation.append(_(u"""* View address: If the selected tweet has geographical information, TWBlue may display a dialogue box where you can read the tweet address. This address is retrieved by sending the geographical coordinates of the tweet to Google maps."""))
-documentation.append(_(u"""* View conversation: If you are focusing a tweet with a mention, it opens a buffer where you can view the whole conversation."""))
-documentation.append(_(u"""* Delete: permanently removes the tweet or direct message which has focus from Twitter and from your lists. Bear in mind that Twitter only allows you to delete tweets you have posted yourself."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""##### User menu"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Actions: Opens a dialogue where you can interact with a user. This dialogue box will be populated with the user who sent the tweet or direct message in focus or the selected user in the friends or followers buffer. You can edit it or leave it as is and choose one of the following actions:"""))
-documentation.append(_(u"""    * Follow: Follows a user. This means you'll see his/her tweets on your home timeline, and if he/she also follows you, you'll be able to exchange direct messages. You may also send / receive direct messages from each other if you have configured the option to allow direct messages from anyone."""))
-documentation.append(_(u"""    * Unfollow: Stops following a user, which causes you not being able to see his/her tweets on your main timeline neither exchanging direct messages, unless they have enabled receiving direct messages from anyone."""))
-documentation.append(_(u"""    * Mute: While muting someone, TWBlue won't show you nor his/her tweets on your main timeline; neither will you see that person's mentions. But you both will be able to exchange direct messages. The muted user is not informed of this action."""))
-documentation.append(_(u"""    * Unmute: this option allows TWBlue to display the user's tweets and mentions again."""))
-documentation.append(_(u"""    * Block: Blocks a user. This forces the user to unfollow you ."""))
-documentation.append(_(u"""    * Unblock: Stops blocking a user."""))
-documentation.append(_(u"""    * Report as spam: this option sends a message to Twitter suggesting the user is performing prohibited practices on the social network."""))
-documentation.append(_(u"""    * Ignore tweets from this client: Adds the client from which the focused tweet was sent to the ignored clients list."""))
-documentation.append(_(u"""* View timeline: Lets you open a user's timeline by choosing the user in a dialog box. It is created when you press enter. If you invoke this option relative to a user that has no tweets, the operation will fail. If you try creating an existing timeline the program will warn you and will not create it again."""))
-documentation.append(_(u"""* Direct message: same action as the button."""))
-documentation.append(_(u"""* Add to List: In order to see someone's tweets in one or more of your lists, you must add them first. In the dialogue box that opens after selecting the user, you will be asked to select the list you wish to add the user to. Thereafter, the list will contain a new member and their tweets will be displayed there."""))
-documentation.append(_(u"""* Remove from list: lets you remove a user from a list."""))
-documentation.append(_(u"""* View lists: Shows the lists created by a specified user."""))
-documentation.append(_(u"""* Show user profile: opens a dialogue with the profile of the specified user."""))
-documentation.append(_(u"""* View favourites: Opens a buffer where you can see the tweets which have been favourited by a particular user."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""##### Buffer menu"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* New trending topics buffer: This opens a buffer to get the worlwide trending topics or those of a country or a city. You'll be able to select from a dialogue box if you wish to retrieve countries' trends, cities' trends or worldwide trends (this option is in the cities' list) and choose one from the selected list. The trending topics buffer will be created once the "OK" button has been activated within the dialogue box. Remember this kind of buffer will be updated every five minutes."""))
-documentation.append(_(u"""* Load previous items: This allows more items to be loaded for the specified buffer."""))
-documentation.append(_(u"""* Mute: Mutes notifications of a particular buffer so you will not hear when new tweets arrive."""))
-documentation.append(_(u"""* autoread: When enabled, the screen reader or SAPI 5 Text to Speech voice (if enabled) will read the text of incoming tweets. Please note that this could get rather chatty if there are a lot of incoming tweets."""))
-documentation.append(_(u"""* Clear buffer: Deletes all items from the buffer."""))
-documentation.append(_(u"""* Destroy: dismisses the list you're on."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""##### Help menu"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Documentation: opens up this file, where you can read some useful program concepts."""))
-documentation.append(_(u"""* Sounds tutorial: Opens a dialog box where you can familiarize yourself with the different sounds of the program."""))
-documentation.append(_(u"""* What's new in this version?: opens up a document with the list of changes from the current version to the earliest."""))
-documentation.append(_(u"""* Check for updates: every time you open the program it automatically checks for new versions. If an update is available, it will ask you if you want to download the update. If you accept, the updating process will commence. When complete, TWBlue will be restarted. This item checks for new updates without having to restart the application."""))
-documentation.append(_(u"""* Report an error: opens up a dialogue box to report a bug by completing a small number of fields. Pressing enter will send the report. If the operation doesn't succeed the program will display a warning."""))
-documentation.append(_(u"""* TWBlue's website: visit our [home page](http://twblue.es) where you can find all relevant information and downloads for TWBlue and become a part of the community."""))
-documentation.append(_(u"""* About TWBlue: shows the credits of the program."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### The invisible user interface"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""The invisible interface, as its name suggests, has no graphical window and works directly with screen readers such as JAWS for Windows, NVDA and System Access. This interface is disabled by default, but you can enable it by pressing Control + M. It works similarly to TheQube and Chicken Nugget. Its shortcuts are similar to those found in these two clients. In addition, the program has builtin support for the keymaps for these applications, configurable through the global settings dialogue. By default, you cannot use this interface's shortcuts in the GUI, but you can configure this in the global settings dialogue."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""The next section contains a list of keyboard shortcuts for both interfaces. Bear in mind that we will only describe the default keymap."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Keyboard shortcuts"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### Shortcuts of the graphical user interface (GUI)"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Enter: Open URL."""))
-documentation.append(_(u"""* Control + Enter: Play audio."""))
-documentation.append(_(u"""* Control + M: Hide the GUI."""))
-documentation.append(_(u"""* Control + N: Compose a new tweet."""))
-documentation.append(_(u"""* Control + R: Reply / mention."""))
-documentation.append(_(u"""* Control + Shift + R: Retweet."""))
-documentation.append(_(u"""* Control + D: Send a direct message."""))
-documentation.append(_(u"""* control + F: Add tweet to favourites."""))
-documentation.append(_(u"""* Control + Shift + F: Remove a tweet from favourites."""))
-documentation.append(_(u"""* Control + S: Open the user actions dialogue."""))
-documentation.append(_(u"""* Control + Shift + V: Show tweet."""))
-documentation.append(_(u"""* Control + Q: Quit this program."""))
-documentation.append(_(u"""* Control + I: Open user timeline."""))
-documentation.append(_(u"""* Control + Shift + i: Destroy buffer."""))
-documentation.append(_(u"""* F5: Increase volume by 5%."""))
-documentation.append(_(u"""* F6: Decrease volume by 5%."""))
-documentation.append(_(u"""* Control + P: Edit your profile."""))
-documentation.append(_(u"""* Control + Delete: Delete a tweet or direct message."""))
-documentation.append(_(u"""* Control + Shift + Delete: Empty the current buffer."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### Shortcuts of the invisible interface (default keymap)"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Control + Windows + Up Arrow: moves to the previous item in the buffer."""))
-documentation.append(_(u"""* Control + Windows + Down Arrow: moves to the next item in the buffer."""))
-documentation.append(_(u"""* Control + Windows + Left Arrow: Move to the previous buffer."""))
-documentation.append(_(u"""* Control + Windows + Right Arrow: Move to the next buffer."""))
-documentation.append(_(u"""* Control + Windows + Shift + Left: Focus the previous session."""))
-documentation.append(_(u"""* Control + Windows + Shift + Right: Focus the next session."""))
-documentation.append(_(u"""* Control + Windows + C: View conversation."""))
-documentation.append(_(u"""* Control + Enter: Open URL."""))
-documentation.append(_(u"""* Control + Windows + Enter: Play audio."""))
-documentation.append(_(u"""* Control + Windows + M: Show or hide the GUI."""))
-documentation.append(_(u"""* Control + Windows + N: New tweet."""))
-documentation.append(_(u"""* Control + Windows + R: Reply / Mention."""))
-documentation.append(_(u"""* Control + Windows + Shift + R: Retweet."""))
-documentation.append(_(u"""* Control + Windows + D: Send direct message."""))
-documentation.append(_(u"""* Windows+ Alt + F: Mark as favourite."""))
-documentation.append(_(u"""* Alt + Windows + Shift + F: Remove from favourites."""))
-documentation.append(_(u"""* Control + Windows + S: Open the user actions dialogue."""))
-documentation.append(_(u"""* Control + Windows + Alt + N: See user details."""))
-documentation.append(_(u"""* Control + Windows + V: Show tweet."""))
-documentation.append(_(u"""* Control + Windows + F4: Quit TWBlue."""))
-documentation.append(_(u"""* Control + Windows + I: Open user timeline."""))
-documentation.append(_(u"""* Control + Windows + Shift + I: Destroy buffer."""))
-documentation.append(_(u"""* Control + Windows + Alt + Up: Increase volume by 5%."""))
-documentation.append(_(u"""* Control + Windows + Alt + Down: Decrease volume by 5%."""))
-documentation.append(_(u"""* Control + Windows + Home: Jump to the first element of the current buffer."""))
-documentation.append(_(u"""* Control + Windows + End: Jump to the last element of the current buffer."""))
-documentation.append(_(u"""* Control + Windows + PageUp: Jump 20 elements up in the current buffer."""))
-documentation.append(_(u"""* Control + Windows + PageDown: Jump 20 elements down in the current buffer."""))
-documentation.append(_(u"""* Windows + Alt + P: Edit profile."""))
-documentation.append(_(u"""* Control + Windows + Delete: Delete a tweet or direct message."""))
-documentation.append(_(u"""* Control + Windows + Shift + Delete: Empty the current buffer."""))
-documentation.append(_(u"""* Control + Windows + Space: Repeat last item."""))
-documentation.append(_(u"""* Control + Windows + Shift + C: Copy to clipboard."""))
-documentation.append(_(u"""* Control + Windows+ A: Add user to list."""))
-documentation.append(_(u"""* Control + Windows + Shift + A: Remove user from list."""))
-documentation.append(_(u"""* Control + Windows + M: Mute / unmute the current buffer."""))
-documentation.append(_(u"""* Windows + Alt + M: Mute / unmute the current session."""))
-documentation.append(_(u"""* Control + Windows + E: Toggle the automatic reading of incoming tweets in the current buffer."""))
-documentation.append(_(u"""* Control + Windows + -: Search on Twitter."""))
-documentation.append(_(u"""* Control + Windows + K: Show the keystroke editor."""))
-documentation.append(_(u"""* Control + Windows + L: Show lists for a specified user."""))
-documentation.append(_(u"""* Windows + Alt + PageUp: Load previous items for the current buffer."""))
-documentation.append(_(u"""* Control + Windows + G: Get geolocation."""))
-documentation.append(_(u"""* Control + Windows + Shift + G: Display the tweet's geolocation in a dialogue."""))
-documentation.append(_(u"""* Control + Windows + T: Create a trending topics' buffer."""))
-documentation.append(_(u"""* Control + Windows + {: Find a string in the current buffer."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Configuration"""))
-documentation.append(_(u"""As described above, this application has two configuration dialogues, the global settings dialogue and the account settings dialogue."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### The account settings dialogue"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### General tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Autocompletion settings: Allows you to configure the autocompletion database. You can add users manually or let TWBlue add your followers, friends or both."""))
-documentation.append(_(u"""* Relative timestamps: Allows you to configure whether the application will calculate the time the tweet or direct message was sent or received based on the current time, or simply say the time it was received or sent."""))
-documentation.append(_(u"""* API calls: Allows you to adjust the number of API calls to be made to Twitter by this program."""))
-documentation.append(_(u"""* Items on each API call: Allows you to specify how many items should be retrieved from Twitter for each API call (default and maximum is 200)."""))
-documentation.append(_(u"""* Inverted buffers: Allows you to specify whether the buffers should be inverted, which means that the oldest items will show at the end of them and the newest at the beginning."""))
-documentation.append(_(u"""* Retweet mode: Allows you to specify the behaviour when posting a retweet: you can choose between retweeting with a comment, retweeting without comment or being asked."""))
-documentation.append(_(u"""* Number of items per buffer to cache in database: This allows you to specify how many items TWBlue should cache in a database. You can type any number, 0 to cache all items, or leave blank to disable caching entirely."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### buffers tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""This tab displays a list for each buffer you have available in TWBlue, except for searches, timelines, favourites' timelines and lists. You can show, hide and move them."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### The ignored clients tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""In this tab, you can add and remove clients to be ignored by the program."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### Sound tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""In this tab, you can adjust the sound volume, select the input and output device and set the soundpack used by the program."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### Audio service tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""In this tab, you can enter your SndUp API key (if you have one) to upload audio to SndUp with your account. Note that if account credentials are not specified you will upload anonimously."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""### Global settings"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""This dialogue allows you to configure some settings which will affect the entire application."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### General tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* Language: This allows you to change the language of this program. Currently supported languages are arabic, Catalan, German, English, Spanish, Basque, Finnish, French, Galician, Croatian, Hungarian, Italian, Polish, Portuguese, Russian and Turkish."""))
-documentation.append(_(u"""* Ask before exiting TWBlue: This checkbox allows you to control whetherthe program will ask for confirmation before exiting."""))
-documentation.append(_(u"""* Play a sound when TWBlue launches: This checkbox allows you to configure whether the application will play a sound when it has finished loading the buffers."""))
-documentation.append(_(u"""* Speak a message when TWBlue launches: This is the same as the previous option, but this checkbox configures whether the screen reader will say \"ready\"."""))
-documentation.append(_(u"""* Use the invisible interface's shortcuts in the GUI: As the invisible interface and the Graphical User Interface have their own shortcuts, you may want to use the invisible interface's keystrokes all the time. If this option is checked, the invisible interface's shortcuts will be usable in the GUI."""))
-documentation.append(_(u"""* Activate SAPI5 when any other screen reader is not being run: This checkbox allows to activate SAPI 5 TTS when no other screen reader is being run."""))
-documentation.append(_(u"""* Hide GUI on launch: This allows you to configure whether TWBlue will start with the GUI or the invisible interface."""))
-documentation.append(_(u"""* Keymap: This option allows you to change the keymap used by the program in the invisible interface. The shipped keymaps are Default, Qwitter,  Windows 10 and Chicken Nugget. The keymaps are in the \"keymaps\" folder, and you can create new ones. Just create a new \".keymap\" file and change the keystrokes associated with the actions, as it is done in the shipped keymaps."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""#### Proxi tab"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""In this tab you can configure TWBlue to use a Proxy server by completing the fields displayed (server, port, user and password)."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## License, source code and donations"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Tw Blue is free software, licensed under the GNU GPL license, either version 2 or, at your option, any later version. You can view the license in the file named license.txt, or online at <http://www.gnu.org/licenses/old-licenses/gpl-2.0.html>."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""The source code of the program is available on GitHub at <https://www.github.com/manuelcortez/twblue>."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""If you want to donate to the project, you can do so at <http://twblue.es/?q=node/3&language=en>. Thank you for your support!"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Contact"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""If you still have questions after reading this document, if you wish to collaborate to the project in some other way, or if you simply want to get in touch with the application developer, follow the Twitter account [@tw_blue2](https://twitter.com/tw_blue2) or [@manuelcortez00.](https://twitter.com/manuelcortez00) You can also visit [our website](http://twblue.es)"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""## Credits"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""TWBlue is developed and mantained by [Manuel Cortéz](https://twitter.com/manuelcortez00), [José Manuel Delicado](https://twitter.com/jmdaweb), and [Bill Dengler](https://twitter.com/codeofdusk). It's supported and sponsored by [Technow S. L.](https://twitter.com/technow)"""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""We would also like to thank the translators of TWBlue, who have allowed the spreading of the application."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""* English: [Bryner Villalobos](https://twitter.com/Bry_StarkCR) and [Bill Dengler](https://twitter.com/codeofdusk)."""))
-documentation.append(_(u"""* Arabic: [Mohammed Al Shara](https://twitter.com/mohammed0204)."""))
-documentation.append(_(u"""* Catalan: [Joan Rabat](https://twitter.com/joanrabat) and Juan Carlos Rivilla."""))
-documentation.append(_(u"""* Spanish: [Manuel Cortéz](https://twitter.com/manuelcortez00)."""))
-documentation.append(_(u"""* Basque: [Sukil Etxenike](https://twitter.com/sukil2011)."""))
-documentation.append(_(u"""* Finnish: [Jani Kinnunen](https://twitter.com/jani_kinnunen)."""))
-documentation.append(_(u"""* French: [Rémi Ruiz](https://twitter.com/blindhelp38)."""))
-documentation.append(_(u"""* Galician: [Juan Buño](https://twitter.com/Quetzatl_)."""))
-documentation.append(_(u"""* German: [Steffen Schultz](https://twitter.com/schulle4u)."""))
-documentation.append(_(u"""* Croatian: [Zvonimir Stanečić](https://twitter.com/zvonimirek222)."""))
-documentation.append(_(u"""* Hungarian: Robert Osztolykan."""))
-documentation.append(_(u"""* Italian: [Christian Leo Mameli](https://twitter.com/llajta2012)."""))
-documentation.append(_(u"""* Japanese: [Riku](https://twitter.com/riku_sub001)"""))
-documentation.append(_(u"""* Polish: [Pawel Masarczyk.](https://twitter.com/Piciok)"""))
-documentation.append(_(u"""* Portuguese: Odenilton Júnior Santos."""))
-documentation.append(_(u"""* Romanian: [Florian Ionașcu](https://twitter.com/7ro) and [Răzvan Ciule](https://twitter.com/pilgrim89)"""))
-documentation.append(_(u"""* Russian: [Александр Яшин](https://twitter.com/radovest)."""))
-documentation.append(_(u"""* Serbian: [Aleksandar Đurić](https://twitter.com/sokodtreshnje)"""))
-documentation.append(_(u"""* Turkish: [Burak Yüksek](https://twitter.com/burakyuksek)."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""Many thanks also to the people who worked on the documentation. Initially, [Manuel Cortez](https://twitter.com/manuelcortez00) did the documentation in Spanish, and translated to English by [Bryner Villalobos](https://twitter.com/Bry_StarkCR), [Robert Spangler](https://twitter.com/glasscity1837), [Sussan Rey](https://twitter.com/sussanrey17), [Anibal Hernandez](https://twitter.com/anibalmetal), and [Holly Scott-Gardner](https://twitter.com/holly1994). It was updated by [Sukil Etxenike](https://twitter.com/sukil2011), with some valuable corrections by [Brian Hartgen](https://twitter.com/brianhartgen) and [Bill Dengler](https://twitter.com/codeofdusk)."""))
-documentation.append(_(u"""
-"""))
-documentation.append(_(u"""---"""))
-documentation.append(_(u"""Copyright © 2013-2015. Manuel Cortéz"""))

mysc/keys/api_keys.c

@@ -5,19 +5,6 @@ return "key\0";
 char *get_api_secret(){
 return "secret_key\0";
 }
-char *get_dropbox_api_key(){
-return "key\0";
-}
-char *get_dropbox_api_secret(){
-return "secret_key\0";
-}
 char *get_twishort_api_key(){
 return "key\0";
 }
-char *get_bts_user(){
-return "user\0";
-}
-char *get_bts_password(){
-return "pass\0";
-}
-

mysc/keys/api_keys.h

@@ -3,10 +3,6 @@
 
 char *get_api_key();
 char *get_api_secret();
-char *get_dropbox_api_key();
-char *get_dropbox_api_secret();
 char *get_twishort_api_key();
-char *get_bts_user();
-char *get_bts_password();
 
 #endif

mysc/pa.c format/App/AppInfo/appinfo.ini

@@ -1,6 +1,6 @@
 [Format]
 Type=PortableApps.comFormat
-Version=3.3
+Version=3.5
 
 [Details]
 Name=tw blue portable
@@ -20,8 +20,8 @@ CommercialUse=true
 EULAVersion=2
 
 [Version]
-PackageVersion=0.84.0.0
-DisplayVersion=0.84
+PackageVersion=0.95.0.0
+DisplayVersion=0.95
 
 [Control]
 Icons=1

requirements.txt

@@ -0,0 +1,54 @@
+wxpython
+wheel
+six
+configobj
+markdown
+future
+requests
+oauthlib
+requests-oauthlib
+requests-toolbelt
+pypubsub
+geopy
+arrow
+python-dateutil
+futures
+winpaths
+PySocks
+win_inet_pton
+# Install the latest RC of this lib
+# see https://github.com/ssut/py-googletrans/issues/234
+googletrans==4.0.0-rc1
+idna<3,>=2.5
+chardet
+urllib3
+youtube-dl
+python-vlc
+pypiwin32
+pywin32
+certifi
+backports.functools_lru_cache
+cx_freeze
+tweepy
+twitter-text-parser
+pyenchant
+sqlitedict
+cx-Logging
+h11
+h2
+hpack
+hstspreload
+httpcore
+httpx
+hyperframe
+rfc3986
+sniffio
+attrs
+importlib-metadata
+numpy
+pillow
+charset-normalizer
+git+https://github.com/accessibleapps/libloader
+git+https://github.com/accessibleapps/platform_utils
+git+https://github.com/accessibleapps/accessible_output2
+git+https://github.com/accessibleapps/sound_lib

scripts/make_archive.py

@@ -0,0 +1,12 @@
+import  shutil
+import os
+import sys
+
+def create_archive():
+	os.chdir("..\\src")
+	print("Creating zip archive...")
+	folder = "dist"
+	shutil.make_archive("twblue", "zip", folder)
+	os.chdir("..\\scripts")
+
+create_archive()

scripts/twblue.nsi

@@ -1,7 +1,9 @@
 !include "MUI2.nsh"
 !include "LogicLib.nsh"
 !include "x64.nsh"
+Unicode true
 CRCCheck on
+ManifestSupportedOS all
 XPStyle on
 Name "TWBlue"
 OutFile "TWBlue_setup.exe"
@@ -12,10 +14,11 @@ SetCompress auto
 SetCompressor /solid lzma
 SetDatablockOptimize on
 VIAddVersionKey ProductName "TWBlue"
-VIAddVersionKey LegalCopyright "Copyright 2016 Manuel Cortéz."
-VIAddVersionKey ProductVersion "0.84"
-VIAddVersionKey FileVersion "0.84"
-VIProductVersion "0.84.0.0"
+VIAddVersionKey LegalCopyright "Copyright 2014-2021 Manuel Cortéz."
+VIAddVersionKey ProductVersion "0.95.0"
+VIAddVersionKey FileVersion "0.95.0"
+VIProductVersion "0.95.0"
+VIFileVersion "0.95.0"
 !insertmacro MUI_PAGE_WELCOME
 !define MUI_LICENSEPAGE_RADIOBUTTONS
 !insertmacro MUI_PAGE_LICENSE "license.txt"
@@ -24,12 +27,12 @@ var StartMenuFolder
 !insertmacro MUI_PAGE_STARTMENU startmenu $StartMenuFolder
 !insertmacro MUI_PAGE_INSTFILES
 !define MUI_FINISHPAGE_LINK "Visit TWBlue website"
-!define MUI_FINISHPAGE_LINK_LOCATION "http://twblue.es"
+!define MUI_FINISHPAGE_LINK_LOCATION "https://twblue.es"
 !define MUI_FINISHPAGE_RUN "$INSTDIR\TWBlue.exe"
 !insertmacro MUI_PAGE_FINISH
 !insertmacro MUI_UNPAGE_CONFIRM
 !insertmacro MUI_UNPAGE_INSTFILES
-  !insertmacro MUI_LANGUAGE "English"
+!insertmacro MUI_LANGUAGE "English"
 !insertmacro MUI_LANGUAGE "French"
 !insertmacro MUI_LANGUAGE "Spanish"
 !insertmacro MUI_LANGUAGE "Italian"
@@ -69,10 +72,10 @@ WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "D
 WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "UninstallString" '"$INSTDIR\uninstall.exe"'
 WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall" "InstallLocation" $INSTDIR
 WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall" "Publisher" "Manuel Cortéz"
-WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "DisplayVersion" "0.84"
-WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "URLInfoAbout" "http://twblue.es"
+WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "DisplayVersion" "0.95"
+WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "URLInfoAbout" "https://twblue.es"
 WriteRegDWORD HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "VersionMajor" 0
-WriteRegDWORD HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "VersionMinor" 84
+WriteRegDWORD HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "VersionMinor" 0
 WriteRegDWORD HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "NoModify" 1
 WriteRegDWORD HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "NoRepair" 1
 SectionEnd

scripts/upload.py

@@ -0,0 +1,48 @@
+#! /usr/bin/env python
+import sys
+import os
+import glob
+import ftplib
+
+transferred=0
+
+def convert_bytes(n):
+	K, M, G, T, P = 1 << 10, 1 << 20, 1 << 30, 1 << 40, 1 << 50
+	if   n >= P:
+		return '%.2fPb' % (float(n) / T)
+	elif   n >= T:
+		return '%.2fTb' % (float(n) / T)
+	elif n >= G:
+		return '%.2fGb' % (float(n) / G)
+	elif n >= M:
+		return '%.2fMb' % (float(n) / M)
+	elif n >= K:
+		return '%.2fKb' % (float(n) / K)
+	else:
+		return '%d' % n
+
+def callback(progress):
+	global transferred
+	transferred = transferred+len(progress)
+	print("Uploaded {}".format(convert_bytes(transferred),))
+
+ftp_server = os.environ.get("FTP_SERVER") or sys.argv[1]
+ftp_username = os.environ.get("FTP_USERNAME") or sys.argv[2]
+ftp_password = os.environ.get("FTP_PASSWORD") or sys.argv[3]
+
+print("Uploading files to the TWBlue server...")
+print("Connecting to %s" % (ftp_server,))
+connection = ftplib.FTP(ftp_server)
+print("Connected to FTP server {}".format(ftp_server,))
+connection.login(user=ftp_username, passwd=ftp_password)
+print("Logged in successfully")
+connection.cwd("web/pubs")
+files = glob.glob("*.zip")+glob.glob("*.exe")
+print("These files will be uploaded into the version folder: {}".format(files,))
+for file in files:
+	transferred = 0
+	print("Uploading {}".format(file,))
+	with open(file, "rb") as f:
+		connection.storbinary('STOR %s' % file, f, callback=callback, blocksize=1024*1024) 
+print("Upload completed. exiting...")
+connection.quit()

src/Conf.defaults

@@ -9,18 +9,22 @@ relative_times = boolean(default=True)
 max_api_calls = integer(default=1)
 max_tweets_per_call = integer(default=100)
 reverse_timelines = boolean(default=False)
-time_to_check_streams = integer(default=30)
 announce_stream_status = boolean(default=True)
 retweet_mode = string(default="ask")
 persist_size = integer(default=0)
-buffer_order = list(default=list('home','mentions','dm','sent_dm','sent_tweets','favorites','followers','friends','blocks','muted','events'))
+load_cache_in_memory=boolean(default=True)
+show_screen_names = boolean(default=False)
+buffer_order = list(default=list('home','mentions', 'dm', 'sent_dm', 'sent_tweets','favorites','followers','friends','blocks','muted','events'))
 
 [sound]
 volume = float(default=1.0)
 input_device = string(default="Default")
 output_device = string(default="Default")
 session_mute = boolean(default=False)
-current_soundpack = string(default="default")
+current_soundpack = string(default="FreakyBlue")
+indicate_audio = boolean(default=True)
+indicate_geo = boolean(default=True)
+indicate_img = boolean(default=True)
 sndup_api_key = string(default="")
 
 [other_buffers]
@@ -38,4 +42,12 @@ autoread_buffers = list(default=list(mentions, direct_messages, events))
 spelling_language = string(default="")
 save_followers_in_autocompletion_db = boolean(default=False)
 save_friends_in_autocompletion_db = boolean(default=False)
-twishort_enabled = boolean(default=False)
+ocr_language = string(default="")
+
+[reporting]
+braille_reporting = boolean(default=True)
+speech_reporting = boolean(default=True)
+
+[filters]
+
+[user-aliases]

src/accessible_output2/__init__.py

@@ -1,33 +0,0 @@
-from __future__ import absolute_import
-import ctypes
-import os
-import types
-from platform_utils import paths
-
-def load_library(libname, cdll=False):
- if paths.is_frozen():
-  libfile = os.path.join(paths.embedded_data_path(), 'accessible_output2', 'lib', libname)
- else:
-  libfile = os.path.join(paths.module_path(), 'lib', libname)
- if cdll:
-  return ctypes.cdll[libfile]
- else:
-  return ctypes.windll[libfile]
-
-def get_output_classes():
- from . import outputs
- module_type = types.ModuleType
- classes = [m.output_class for m in outputs.__dict__.values() if type(m) == module_type and hasattr(m, 'output_class')]
- return sorted(classes, key=lambda c: c.priority)
-
-def find_datafiles():
- import os
- import platform
- from glob import glob
- import accessible_output2
- if platform.system() != 'Windows':
-  return []
- path = os.path.join(accessible_output2.__path__[0], 'lib', '*.dll')
- results = glob(path)
- dest_dir = os.path.join('accessible_output2', 'lib')
- return [(dest_dir, results)]

src/accessible_output2/outputs/__init__.py

@@ -1,20 +0,0 @@
-from __future__ import absolute_import
-import platform
-if platform.system() == 'Windows':
- from . import nvda
- from . import jaws
- from . import sapi5
- from . import window_eyes
- from . import system_access
- from . import dolphin
- from . import pc_talker
- #import sapi4
-
-if platform.system() == 'Darwin':
- from . import voiceover
- from . import say
-
-if platform.system() == 'Linux':
- from . import e_speak
-
-from . import auto

src/accessible_output2/outputs/auto.py

@@ -1,40 +0,0 @@
-from __future__ import absolute_import
-import accessible_output2
-from .base import Output, OutputError
-
-class Auto(Output):
-
- def __init__(self):
-  output_classes = accessible_output2.get_output_classes()
-  self.outputs = []
-  for output in output_classes:
-   try:
-    self.outputs.append(output())
-   except OutputError:
-    pass
-
- def get_first_available_output(self):
-  for output in self.outputs:
-   if output.is_active():
-    return output
-  return None
-
- def speak(self, *args, **kwargs):
-  output = self.get_first_available_output()
-  if output:
-   output.speak(*args, **kwargs)
-
- def braille(self, *args, **kwargs):
-  output = self.get_first_available_output()
-  if output:
-   output.braille(*args, **kwargs)
-
- def output(self, *args, **kwargs):
-  output = self.get_first_available_output()
-  if output:
-   output.speak(*args, **kwargs)
-
- def is_system_output(self):
-  output = self.get_first_available_output()
-  if output:
-   return output.is_system_output()