Merge branch 'next-gen' into configration_invalid

.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

README.md

@@ -31,7 +31,7 @@ Although most dependencies can be found in the windows-dependencies directory, w
 
 #### Dependencies packaged in windows installers
 
-* [Python,](https://python.org) version 3.8.7  
+* [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.
 
 #### Dependencies that must be installed using pip

appveyor.yml

@@ -1,84 +0,0 @@
-pull_requests:
-  # Avoid building after pull requests. Shall we disable this option?
-  do_not_increment_build_number: true
-
-# Only build whenever we add tags to the repo.
-skip_non_tags: true
-
-environment:
-
-  matrix:
-
-  # List of python versions we want to work with.
-    - PYTHON: "C:\\Python37"
-      PYTHON_VERSION: "3.7.x" # currently 2.7.9
-      PYTHON_ARCH: "32"
-
-  # perhaps we may enable this one in future?
-#    - PYTHON: "C:\\Python37-x64"
-#      PYTHON_VERSION: "3.7.x" # currently 2.7.9
-#      PYTHON_ARCH: "64"
-
-# This is important so we will retrieve everything in submodules as opposed to default method.
-clone_script:
-  - cmd: >-
-      git clone -q --branch=%APPVEYOR_REPO_BRANCH% https://github.com/%APPVEYOR_REPO_NAME%.git %APPVEYOR_BUILD_FOLDER%
-      && cd %APPVEYOR_BUILD_FOLDER%
-      && git checkout -qf %APPVEYOR_REPO_COMMIT%
-      && git submodule update --init --recursive
-
-install:
-  # If there is a newer build queued for the same PR, cancel this one.
-  # The AppVeyor 'rollout builds' option is supposed to serve the same
-  # purpose but it is problematic because it tends to cancel builds pushed
-  # directly to master instead of just PR builds (or the converse).
-  # credits: JuliaLang developers.
-  - ps: if ($env:APPVEYOR_PULL_REQUEST_NUMBER -and $env:APPVEYOR_BUILD_NUMBER -ne ((Invoke-RestMethod `
-        https://ci.appveyor.com/api/projects/$env:APPVEYOR_ACCOUNT_NAME/$env:APPVEYOR_PROJECT_SLUG/history?recordsNumber=50).builds | `
-        Where-Object pullRequestId -eq $env:APPVEYOR_PULL_REQUEST_NUMBER)[0].buildNumber) { `
-          throw "There are newer queued builds for this pull request, failing early." }
-#  - ECHO "Filesystem root:"
-#  - ps: "ls \"C:/\""
-
-  # Check that we have the expected version and architecture for Python
-  - "SET PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
-  - "python --version"
-  - "python -c \"import struct; print(struct.calcsize('P') * 8)\""
-
-  # Upgrade to the latest version of pip to avoid it displaying warnings
-  # about it being out of date.
-  - "python -m pip install --upgrade pip setuptools"
-
-  # Install the build dependencies of the project. If some dependencies contain
-  # compiled extensions and are not provided as pre-built wheel packages,
-  # pip will build them from source using the MSVC compiler matching the
-  # target Python version and architecture
-  - "%CMD_IN_ENV% pip install -r requirements.txt"
-  - "%CMD_IN_ENV% pip install pyenchant"
-
-build_script:
-  # Build documentation at first, so setup.py won't fail when copying everything.
-  - "cd doc"
-  # Import documentation before building, so strings.py will be created.
-  - "%CMD_IN_ENV% python documentation_importer.py"
-  # build doc from src folder so it will generate result files right there.
-  - "cd ..\\src"
-  - "%CMD_IN_ENV% python ..\\doc\\generator.py"
-  # Build distributable files.
-  - "%CMD_IN_ENV% python setup.py build"
-  - "cd dist"
-  # Zip it all.
-  - cmd: 7z a ..\..\snapshot.zip *
-
-artifacts:
-  - path: snapshot.zip
-
-deploy:
-- provider: FTP
-  host: twblue.es
-  protocol: ftp
-  beta: true
-  username: twblue.es
-  password:
-    secure: lQZqpYRnHf4LLVOg0C42NQ==
-  folder: 'web/pubs'

contributors.txt

@@ -39,5 +39,5 @@ florian Ionașcu
 Christian Leo Mameli
 Natalia Hedlund (Наталья Хедлунд)
 Valeria (Валерия)
-Corentin Bacqué-Cazenave
-Artem Plaksin (maniyax)
+Oreonan
+Artem Plaksin (maniyax)

doc/changelog.md

@@ -1,7 +1,61 @@
-TWBlue Changelog
+TWBlue Changelog
 
 ## changes in this version
 
+* We have restored conversation and threads support powered by Twitter API V2 thanks to a set of improvements we have done in the application, as well as more generous limits to Tweet monthly cap by Twitter.
+* Fixed issue when uploading attachments (images, videos or gif files) while sending tweets or replies.
+
+## Changes in version 2021.11.12
+
+* Now it is possible to create a tweet from a trending topics buffer again.
+* TWBlue now includes a completely new set of dialogs to handle tweeting, replying and sending direct messages that takes advantage of more Twitter features.
+    * It is possible to add videos in tweets and direct messages by using the new "add" button, located in every dialog where  media can be added. Twitter suggests to add videos from 5 seconds up to 2 minutes lenght, in mp4 format (video Codec H.264 and audio codec AAC). Currently, TWBlue does not check if the uploaded video complies with Twitter media requirements. You can add only a video in a tweet or direct message. No other kind of media can be added after a video is in a tweet. If the video was unable to be uploaded successfully, the tweet or direct message won't be created.
+    * Now you can add a poll to tweets. Polls can have up to 4 different options and allow voting up to 7 days after being created. Take into account, though, that currently TWBlue does not support reading polls in tweets.
+    * TWBlue now support threads while creating a new tweet. There is a new button, called add tweet which will add the current tweet to the thread and will allow you to write another tweet in the thread. Every tweet might include media (up to 4 photos, or one GIF image or a video) or up to one poll.
+    * Some functionality was removed from tweet dialogs within TWBlue. Particularly, URL shorteners and long tweets via Twishort. You still can read long tweets posted via Twishort, though.
+
+## Changes in version 2021.11.07
+
+* 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.
@@ -12,6 +66,8 @@
 * 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
@@ -213,4 +269,4 @@
 * New followers and friends buffer for user timelines.
 
 ---
-Copyright © 2014-2017, Manuel Cortez.
+Copyright © 2014-2021, Manuel Cortez.

doc/documentation_importer.py

@@ -1,28 +1,27 @@
 # -*- coding: utf-8 -*-
-from codecs import open
 """ 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 translatable  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", 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 = "\"\","
-		elif "\n" == i[-1]:
-			newvar = "_(u\"\"\"%s\"\"\"),\n" % (i[:-1])
-		else:
-			newvar = "_(u\"\"\"%s\"\"\"),\n" % (i)
-		f2.write(newvar)
-	f1.close()
-	f2.write("]")
-	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")

doc/generator.py

@@ -5,62 +5,83 @@ import locale
 import paths
 import markdown
 import shutil
-from codecs import open as _open
 from importlib import reload
 
-def change_language(name, language):
- global _
- os.environ["lang"] = language
- _ = gettext.install(name, os.path.join(paths.app_path(), "locales"))
+# Languages already translated or translating the documentation.
+documentation_languages = ["en", "es", "fr", "de", "it", "gl", "ja", "ru", "ro", "eu", "ca", "da", "sr"]
 
-# the list of supported language codes of TW Blue
-languages = ["en", "es", "fr", "de", "it", "gl", "ja", "ru", "ro", "eu", "ca", "da"]
 
-def generate_document(language, document_type="documentation"):
- if document_type == "documentation":
-  translation_file = "twblue-documentation"
-  change_language(translation_file, language)
-  reload(strings)
-  markdown_file = markdown.markdown("\n".join(strings.documentation[1:]), extensions=["markdown.extensions.toc"])
-  title = strings.documentation[0]
-  filename = "manual.html"
- elif document_type == "changelog":
-  translation_file = "twblue-changelog"
-  change_language(translation_file, language)
-  reload(changelog)
-  markdown_file = markdown.markdown("\n".join(changelog.documentation[1:]), extensions=["markdown.extensions.toc"])
-  title = 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>
-  """ %  (language, 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", language)):
-  os.mkdir(os.path.join("documentation", language))
- mdfile = _open(os.path.join("documentation", language, filename), "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")
- 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 languages:
-  print("Creating documentation for: %s" % (i,))
-  generate_document(i)
-  generate_document(i, "changelog")
- 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")
 
-change_language("twblue-documentation", "en")
+install_null_translation("twblue-documentation")
 import strings
 import changelog
 create_documentation()

doc/locales/ar/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-07 13:48-0500\n"
 "Last-Translator: Manuel Cortez <manuel@manuelcortez.net>\n"
 "Language-Team: \n"

doc/locales/ar/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2015-11-27 08:32-0600\n"
 "Last-Translator: Manuel Cortéz <manuel@manuelcortez.net>\n"
 "Language-Team: Mohammed Al Shara <mohammed@atexplorer.com>\n"

doc/locales/ca/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TWBlue-Changelog V0.93\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 11:46+0200\n"
 "Last-Translator: Manuel Cortez <manuel@manuelcortez.net>\n"
 "Language-Team: Fran Torres Gallego. <frantorresgallego@gmail.com>\n"

doc/locales/ca/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.89\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2017-03-25 15:15+0100\n"
 "Last-Translator: Joan Rabat <joanrabat@hotmail.com>\n"
 "Language-Team: Francisco Torres Gallego <frantorresgallego@gmail.com>\n"

doc/locales/da/LC_MESSAGES/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-11-17 10:25+0100\n"
 "Last-Translator: Nicolai Svendsen <chojiro1990@gmail.com>\n"
 "Language-Team: \n"

doc/locales/de/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2019-03-17 16:39+0100\n"
 "Last-Translator: Steffen Schultz <steffenschultz@mailbox.org>\n"
 "Language-Team: \n"

doc/locales/de/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TWBlue Documentation\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 11:01+0200\n"
 "Last-Translator: Steffen Schultz <schulle3o@yahoo.de>\n"
 "Language-Team: Steffen Schultz <schulle3o@yahoo.de>\n"

doc/locales/es/LC_MESSAGES/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: twblue-documentation 0.84\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2019-05-06 23:06+0200\n"
 "Last-Translator: José Manuel Delicado <jmdaweb@hotmail.com>\n"
 "Language-Team: Spanish <manuel@manuelcortez.net>\n"

doc/locales/eu/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-07 13:51-0500\n"
 "Last-Translator: Manuel Cortez <manuel@manuelcortez.net>\n"
 "Language-Team: \n"

doc/locales/eu/lc_messages/twblue-changelog.temp.temp.po

@@ -1,635 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) YEAR ORGANIZATION
-# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
-#
-msgid ""
-msgstr ""
-"Project-Id-Version: \n"
-"POT-Creation-Date: 2017-07-08 16:25+Hora de verano central (Mxico)\n"
-"PO-Revision-Date: 2017-07-15 19:44+0200\n"
-"Last-Translator: Sukil Etxenike <sukiletxe@yahoo.es>\n"
-"Language-Team: \n"
-"Language: eu\n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-"Generated-By: pygettext.py 1.5\n"
-"X-Generator: Poedit 2.0.1\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
-
-#: ../doc/changelog.py:3
-msgid "TWBlue Changelog"
-msgstr "TwBlueren aldaketak"
-
-#: ../doc/changelog.py:4
-msgid "## changes in this version"
-msgstr "## Aldaketak bertsio honetan"
-
-#: ../doc/changelog.py:5
-msgid ""
-"* TWBlue will show an error when trying to open a timeline for a suspended "
-"user. ([#128](https://github.com/manuelcortez/TWBlue/issues/128))"
-msgstr ""
-"* TWBluek errore bat erakutsiko du ezabatutako erabiltzaile batn denbora "
-"lerro bat irekitzen saiatzean . ([#128](https://github.com/manuelcortez/"
-"TWBlue/issues/128))"
-
-#: ../doc/changelog.py:6
-msgid ""
-"* Removed TwUp as service as it no longer exists. ([#112](https://github.com/"
-"manuelcortez/TWBlue/issues/112))"
-msgstr ""
-"* TwUp zerbitzua kendu da, jada ez delako existitzen. ([#112](https://github."
-"com/manuelcortez/TWBlue/issues/112)) "
-
-#: ../doc/changelog.py:7
-msgid ""
-"* Release audio files after uploading them. ([#130](https://github.com/"
-"manuelcortez/TWBlue/issues/130))"
-msgstr ""
-"* Orain audio fitxategiak askatzen dira igo ondoren. ([#130](https://github."
-"com/manuelcortez/TWBlue/issues/130))"
-
-#: ../doc/changelog.py:8
-msgid ""
-"* Now TWBlue will use Yandex's translation services instead microsoft "
-"translator. ([#132](https://github.com/manuelcortez/TWBlue/issues/132))"
-msgstr ""
-"* Orain TWBluek Yandexen itzultzailea erabiltzen du Microsoften "
-"itzultzailearen ordez. ([#132](https://github.com/manuelcortez/TWBlue/"
-"issues/132))"
-
-#: ../doc/changelog.py:9
-msgid ""
-"* 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))"
-msgstr ""
-"* SndUp-en erabiltzaileek orain audioak igo ditzakete haien API kodea "
-"erabilita. ([#134](https://github.com/manuelcortez/TWBlue/issues/134))"
-
-#: ../doc/changelog.py:10
-msgid ""
-"* 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))"
-msgstr ""
-"* Txio zaharrak ez lirateke buferretan elementu berri gisa agertu behar. "
-"([#116,](https://github.com/manuelcortez/TWBlue/issues/116)) ([#133](https://"
-"github.com/manuelcortez/TWBlue/issues/133))"
-
-#: ../doc/changelog.py:11
-msgid ""
-"* 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))"
-msgstr ""
-"* Aipatutako erabiltzaile guztiak ondo agertu beharko lirateke Tuishort-en "
-"txio luzeetan. ([#116,](https://github.com/manuelcortez/TWBlue/issues/116)) "
-"([#135](https://github.com/manuelcortez/TWBlue/issues/135))"
-
-#: ../doc/changelog.py:12
-msgid ""
-"* 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))"
-msgstr ""
-
-#: ../doc/changelog.py:13
-msgid ""
-"* 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)"
-msgstr ""
-
-#: ../doc/changelog.py:14
-msgid "* And more ([#136,](https://github.com/manuelcortez/TWBlue/issues/136))"
-msgstr ""
-
-#: ../doc/changelog.py:15
-msgid "## Changes in version 0.90"
-msgstr ""
-
-#: ../doc/changelog.py:16
-msgid ""
-"* Fixed a bug in long tweet parsing that was making TWBlue to disconnect the "
-"streaming API. ([#103](https://github.com/manuelcortez/TWBlue/issues/103))"
-msgstr ""
-
-#: ../doc/changelog.py:17
-msgid ""
-"* 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))"
-msgstr ""
-
-#: ../doc/changelog.py:18
-msgid ""
-"* 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))"
-msgstr ""
-
-#: ../doc/changelog.py:19
-msgid ""
-"* 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))"
-msgstr ""
-
-#: ../doc/changelog.py:20
-msgid ""
-"* The spellchecker module should select the right language when is set to "
-"\"user default\". ([#117](https://github.com/manuelcortez/TWBlue/issues/117))"
-msgstr ""
-
-#: ../doc/changelog.py:21
-msgid ""
-"* Image description will be displayed in retweets too. ([#119](https://"
-"github.com/manuelcortez/TWBlue/issues/119))"
-msgstr ""
-
-#: ../doc/changelog.py:22
-msgid ""
-"* When reading a long tweet, you shouldn't read strange entities anymore. "
-"([#118](https://github.com/manuelcortez/twblue/issues/118))"
-msgstr ""
-
-#: ../doc/changelog.py:23
-msgid ""
-"* TWBlue will not try to load timelines if the user is blocking you. ([#125]"
-"(https://github.com/manuelcortez/twblue/issues/125))"
-msgstr ""
-
-#: ../doc/changelog.py:24
-msgid "## Changes in version 0.88 and 0.89"
-msgstr ""
-
-#: ../doc/changelog.py:25
-msgid "* Fixed more issues with streams and reconnections."
-msgstr ""
-
-#: ../doc/changelog.py:26
-msgid "* newer updates will indicate the release date in the updater."
-msgstr ""
-
-#: ../doc/changelog.py:27
-msgid ""
-"* Changes to keystrokes are reflected in keystroke editor automatically."
-msgstr ""
-
-#: ../doc/changelog.py:28
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:29
-msgid ""
-"* Fixed a bug that caused duplicated user mentions in replies when the tweet "
-"was made with Twishort."
-msgstr ""
-
-#: ../doc/changelog.py:30
-msgid ""
-"* Retweets should be displayed normally again when the originating tweet is "
-"a Twishort's long tweet."
-msgstr ""
-
-#: ../doc/changelog.py:31
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:32
-msgid ""
-"* Added a new setting in the account settings dialogue that makes TWBlue to "
-"show twitter usernames instead the full name."
-msgstr ""
-
-#: ../doc/changelog.py:33
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:34
-msgid "* Now TWBlue will play a sound when the focused tweet contains  images."
-msgstr ""
-
-#: ../doc/changelog.py:35
-msgid ""
-"* Your own quoted tweets will not appear in the mentions buffer anymore."
-msgstr ""
-
-#: ../doc/changelog.py:36
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:37
-msgid "* Mentioning people from friends or followers buffers works again."
-msgstr ""
-
-#: ../doc/changelog.py:38
-msgid ""
-"* Support for proxy servers has been improved. Now TWBlue supports http, "
-"https, socks4 and socks5 proxies, with and without autentication."
-msgstr ""
-
-#: ../doc/changelog.py:39
-msgid "## Changes in version 0.87"
-msgstr ""
-
-#: ../doc/changelog.py:40
-msgid "* Fixed stream connection errors."
-msgstr ""
-
-#: ../doc/changelog.py:41
-msgid ""
-"* Now TWBlue can handle properly a reply to the sender without including all "
-"other mentioned users."
-msgstr ""
-
-#: ../doc/changelog.py:42
-msgid "* Updated translations."
-msgstr ""
-
-#: ../doc/changelog.py:43
-msgid ""
-"* The status of the mention to all checkbox will be remembered the next time "
-"you  reply to multiple users."
-msgstr ""
-
-#: ../doc/changelog.py:44
-msgid "## Changes in version 0.86"
-msgstr ""
-
-#: ../doc/changelog.py:45
-msgid ""
-"* Fixed a very important security issue. Now TWBlue will send tweets to "
-"twishort without using any other server."
-msgstr ""
-
-#: ../doc/changelog.py:46
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:47
-msgid ""
-"* Updated windows 10 keymap for reflecting changes made in the last windows "
-"10 build."
-msgstr ""
-
-#: ../doc/changelog.py:48
-msgid "* Added last changes in the twitter API."
-msgstr ""
-
-#: ../doc/changelog.py:49
-msgid ""
-"* When replying, it will not show the twitter username in the text box. When "
-"you send the tweet, the username will be added automatically."
-msgstr ""
-
-#: ../doc/changelog.py:50
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:51
-msgid "## Changes in version 0.85"
-msgstr ""
-
-#: ../doc/changelog.py:52
-msgid "* Long and quoted tweets should be displayed properly In lists."
-msgstr ""
-
-#: ../doc/changelog.py:53
-msgid "* The connection should be more stable."
-msgstr ""
-
-#: ../doc/changelog.py:54
-msgid "* Added an autostart option in the global settings dialogue."
-msgstr ""
-
-#: ../doc/changelog.py:55
-msgid "* Updated translation."
-msgstr ""
-
-#: ../doc/changelog.py:56
-msgid "* Updated russian documentation."
-msgstr ""
-
-#: ../doc/changelog.py:57
-msgid "* Tweets in cached database should be loaded properly."
-msgstr ""
-
-#: ../doc/changelog.py:58
-msgid "* Added some missed dictionaries for spelling correction."
-msgstr ""
-
-#: ../doc/changelog.py:59
-msgid ""
-"* Timelines, lists and other buffer should be created in the right order at "
-"startup."
-msgstr ""
-
-#: ../doc/changelog.py:60
-msgid "## Changes in version 0.84 "
-msgstr ""
-
-#: ../doc/changelog.py:61
-msgid "* More improvements in quoted and long tweets."
-msgstr ""
-
-#: ../doc/changelog.py:62
-msgid ""
-"* Updated translations: Russian, Italian, French, Romanian, Galician and "
-"Finnish."
-msgstr ""
-
-#: ../doc/changelog.py:63
-msgid ""
-"* Improvements in the audio uploader module: Now it can handle audio with "
-"non-english characters."
-msgstr ""
-
-#: ../doc/changelog.py:64
-msgid ""
-"* the title of the window should be updated properly when spellcheck, "
-"translate or shorten/unshorten URL buttons are pressed."
-msgstr ""
-
-#: ../doc/changelog.py:65
-msgid ""
-"* the bug that changes the selected tweet in the home timeline shouldn't be "
-"happening so often."
-msgstr ""
-
-#: ../doc/changelog.py:66
-msgid "## Changes in version 0.82 and 0.83"
-msgstr ""
-
-#: ../doc/changelog.py:67
-msgid ""
-"* If the tweet source (client) is an application with unicode characters "
-"(example: российская газета) it will not break the tweet displayer."
-msgstr ""
-
-#: ../doc/changelog.py:68
-msgid ""
-"* Added a new field for image description in tweet displayer. When "
-"available, it will show description for images posted in tweets."
-msgstr ""
-
-#: ../doc/changelog.py:69
-msgid ""
-"* users can add image descriptions to their photos. When uploading an image, "
-"a dialog will show for asking a description."
-msgstr ""
-
-#: ../doc/changelog.py:70
-msgid "* Redesigned upload image dialog."
-msgstr ""
-
-#: ../doc/changelog.py:71
-msgid "* Fixed photo uploads when posting tweets."
-msgstr ""
-
-#: ../doc/changelog.py:72
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:73
-msgid "* Added audio playback from soundcloud."
-msgstr ""
-
-#: ../doc/changelog.py:74
-msgid "* Now the session mute option don't makes the screen reader speaks."
-msgstr ""
-
-#: ../doc/changelog.py:75
-msgid "* Fixed the direct message dialog. Now it should be displayed properly."
-msgstr ""
-
-#: ../doc/changelog.py:76
-msgid ""
-"* when a tweet is deleted in twitter, TWBlue should reflect this change and "
-"delete that tweet in every buffer it is displayed."
-msgstr ""
-
-#: ../doc/changelog.py:77
-msgid ""
-"* If your session is broken, TWBlue will be able to remove it automatically "
-"instead just crashing."
-msgstr ""
-
-#: ../doc/changelog.py:78
-msgid "* audio uploader should display the current progress."
-msgstr ""
-
-#: ../doc/changelog.py:79
-msgid ""
-"* users can disable the check for updates feature at startup from the "
-"general tab, in the global settings dialogue."
-msgstr ""
-
-#: ../doc/changelog.py:80
-msgid ""
-"* The invisible interface and the window should be synchronized when the "
-"client reconnects."
-msgstr ""
-
-#: ../doc/changelog.py:81
-msgid "* The documentation option in the systray icon should be enabled."
-msgstr ""
-"* Sistemaren ikonoetako dokumentazioa ikusteko aukera erabilgarria egon "
-"beharko litzateke."
-
-#: ../doc/changelog.py:82
-msgid ""
-"* In trending buffers, you can press enter for posting a tweet about  the "
-"focused trend."
-msgstr ""
-"* Tendentzien buferretan, enter saka dezakezu enfokatutako tendentziari "
-"buruz txio bat argitaratzeko."
-
-#: ../doc/changelog.py:83
-msgid ""
-"* Updated russian documentation and main program interface (thanks to "
-"Natalia Hedlund (Наталья Хедлунд), [@lifestar_n](https://twitter.com/"
-"lifestar_n) in twitter)"
-msgstr ""
-
-#: ../doc/changelog.py:84
-msgid "* updated translations."
-msgstr "* Itzulpenak eguneratuak izan dira."
-
-#: ../doc/changelog.py:85
-msgid "## Changes in Version 0.81"
-msgstr "## 0.81bertsioaren aldaketak"
-
-#: ../doc/changelog.py:86
-msgid "* Updated translations"
-msgstr "* Itzulpenak eguneratuak izan dira"
-
-#: ../doc/changelog.py:87
-msgid ""
-"* 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."
-msgstr ""
-
-#: ../doc/changelog.py:88
-msgid "* some GUI elements now use keyboard shortcuts for common actions."
-msgstr ""
-"* Interfaze grafikoko elementu batzuek lasterbide teklak dituzte ohiko "
-"ekintzetarako."
-
-#: ../doc/changelog.py:89
-msgid "* fixed a bug in the geolocation dialog."
-msgstr "* Errore bat konpondu da geottxioen elkarrizketa-koadroan."
-
-#: ../doc/changelog.py:90
-msgid "* the chicken nugget keymap should work properly."
-msgstr "* Chicken Nuggetaren teklatu-mapak ondo funtzionatu beharko luke."
-
-#: ../doc/changelog.py:91
-msgid ""
-"* Added a new soundpack to the default installation of TWBlue, thanks to "
-"[@Deng90](https://twitter.com/deng90)"
-msgstr ""
-"* Soinu pakete berri bat gehitu zaio TWBlueren lehenetsitako instalazioari, "
-"eskerrak [@Deng90](https://twitter.com/deng90)"
-
-#: ../doc/changelog.py:92
-msgid "* Now the changelog is  written in an html File."
-msgstr "* Orain aldaketen fitxategia html fitxategi bat da."
-
-#: ../doc/changelog.py:93
-msgid ""
-"* Added some missed dictionaries in last version for the spell checking "
-"feature."
-msgstr ""
-"* Aurreko bertsioan falta ziren hiztegi batzuk gehitu dira, zuzentzaleak "
-"erabiltzen dituenak."
-
-#: ../doc/changelog.py:94
-msgid ""
-"* Trimmed the beginnings of the sounds in the default soundpack. Thanks to "
-"[@masonasons](https://github.com/masonasons)"
-msgstr ""
-"* ehenetsitako soiinu paketearen soinuen hasierak moztu dira. Eskerrak "
-"[@masonasons-i.](https://github.com/masonasons)"
-
-#: ../doc/changelog.py:95
-msgid ""
-"* Added Opus support for sound playback in TWBlue. Thanks to [@masonasons]"
-"(https://github.com/masonasons)"
-msgstr ""
-"* Opus formatua erreproduzi daiteke, eskerrak [@masonasons-i.](https://"
-"github.com/masonasons)."
-
-#: ../doc/changelog.py:96
-msgid ""
-"* Added a source field in view tweet dialogue. Thanks to [@masonasons]"
-"(https://github.com/masonasons)"
-msgstr ""
-"* \"Iturria\" gehitu zaio txioa erakusteko elkarrizketa koadroari. Eskerrak "
-"[@masonasons-i.](https://github.com/masonasons)"
-
-#: ../doc/changelog.py:97
-msgid ""
-"* You can load previous items in followers and friend buffers for others."
-msgstr ""
-"* Aurreko elementuak karga ditzakezu besteen jarraitzaile eta lagunen "
-"buferretan."
-
-#: ../doc/changelog.py:98
-msgid ""
-"* 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)"
-msgstr ""
-"* Zuzentzailearen elkarrizketa-koadroak ez luke errorerik erakutsi behar "
-"aukera globaletan \"Lehenetsitako hizkuntza\" aukeratua dagoenean eta zure "
-"hizkuntza erabilgarria denean [#168](http://twblue.es/bugs/view.php?id=168)"
-
-#: ../doc/changelog.py:99
-msgid "* Updated romanian translation."
-msgstr "* Errumaniera itzulpena eguneratua izan da."
-
-#: ../doc/changelog.py:100
-msgid "* Some code cleanups."
-msgstr "* Kode garbiketa batzuk."
-
-#: ../doc/changelog.py:101
-msgid "* The bug reports feature is fully operational again."
-msgstr "* Arazoez informatzeko ezaugarriak berriz funtzionaten du"
-
-#: ../doc/changelog.py:102
-msgid ""
-"* TWBlue should work again for users that contains special characters in "
-"windows usernames."
-msgstr ""
-"* TWBluek berriz funtzionatu beharko luke haien Windows erabiltzaile-"
-"izenetan karaktere bereziak dituzten erabiltzaileentzat."
-
-#: ../doc/changelog.py:103
-msgid "* Added more options for the tweet searches."
-msgstr "* Txioen bilaketarako aukera gehiago gehitu dira."
-
-#: ../doc/changelog.py:104
-msgid "* Added play_audio to the keymap editor."
-msgstr "* play_audio teklatu-mapen editorera gehitua izan da."
-
-#: ../doc/changelog.py:105
-msgid "* Windows key is no longer required in the keymap editor"
-msgstr "* Windows tekla ez da jada bearrezkoa teklatu-mapen editorean."
-
-#: ../doc/changelog.py:106
-msgid "* Switched to the Microsoft translator."
-msgstr "* Microsoften itzultzailera aldatu gara."
-
-#: ../doc/changelog.py:107
-msgid ""
-"* You can update the current buffer by pressing ctrl+win+shift+u in the "
-"default keymap or in the buffer menu."
-msgstr ""
-"* Enfokatutako uferra ktrl+shift+win+u sakatuta (lehenetsitako teklatu-"
-"mapak) edo menuan eguneratu daitezke."
-
-#: ../doc/changelog.py:108
-msgid "* Changed some keystrokes in the windows 10 default keymap"
-msgstr ""
-"* Lasterbide-tekla batzuk aldatuak izan dira Windows 10erako teklatu-mapan."
-
-#: ../doc/changelog.py:109
-msgid "* New followers and friends buffer for user timelines."
-msgstr ""
-"* Jarraitzaileen eta lagunen bufer berria erabiltzaileen denbora-lerroentzat."
-
-#: ../doc/changelog.py:110
-msgid "---"
-msgstr "---"
-
-#: ../doc/changelog.py:111
-msgid "Copyright © 2014-2017, Manuel Cortez."
-msgstr "Copyright © 2014-2017, Manuel Cortez."

doc/locales/eu/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2015-11-27 08:33-0600\n"
 "Last-Translator: Manuel Cortéz <manuel@manuelcortez.net>\n"
 "Language-Team: Sukil Echenique <sukiletxe@yahoo.es>\n"

doc/locales/fi/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-07 13:52-0500\n"
 "Last-Translator: Manuel Cortez <manuel@manuelcortez.net>\n"
 "Language-Team: \n"

doc/locales/fi/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-27 16:37+0200\n"
 "Last-Translator: Jani Kinnunen <jani.kinnunen@wippies.fi>\n"
 "Language-Team: \n"

doc/locales/fr/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: twblue-changelog 0.93\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estándar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2019-07-22 16:16+0200\n"
 "Last-Translator: Corentin BACQUÉ-CAZENAVE <corentin@progaccess33.net>\n"
 "Language-Team: Corentin BACQUÉ-CAZENAVE <corentin@progaccess.net>\n"

doc/locales/fr/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.88\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-11 12:25+0200\n"
 "Last-Translator: Rémy Ruiz <remyruiz@gmail.com>\n"
 "Language-Team: Rémy Ruiz <remyruiz@gmail.com>\n"

doc/locales/gl/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2019-05-12 22:19+0100\n"
 "Last-Translator: \n"
 "Language-Team: \n"

doc/locales/gl/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: tw blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 11:34+0100\n"
 "Last-Translator: Juan C. Buño <oprisniki@gmail.com>\n"
 "Language-Team: Alba Quinteiro <alba_080695@hotmail.com>\n"

doc/locales/hu/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2017-12-11 11:07-0600\n"
 "Last-Translator: \n"
 "Language-Team: \n"

doc/locales/hu/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2015-11-27 08:34-0600\n"
 "Last-Translator: Manuel Cortéz <manuel@manuelcortez.net>\n"
 "Language-Team: \n"

doc/locales/it/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2017-12-11 11:07-0600\n"
 "Last-Translator: \n"
 "Language-Team: \n"

doc/locales/it/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-09 11:51+0100\n"
 "Last-Translator: Chris Leo Mameli <llajta2012@gmail.com>\n"
 "Language-Team: \n"

doc/locales/ja/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 19:52+0900\n"
 "Last-Translator: \n"
 "Language-Team: \n"

doc/locales/ja/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 19:09+0900\n"
 "Last-Translator: Masamitsu Misono <misono@nvsupport.org>\n"
 "Language-Team: NVDA Help Desk <nvdahelp@center-aikoh.net>\n"

doc/locales/pl/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2017-12-11 11:08-0600\n"
 "Last-Translator: zvonimir stanecic <zvonimirek222@yandex.com>\n"
 "Language-Team: \n"

doc/locales/pl/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2017-01-22 21:42+0100\n"
 "Last-Translator: Zvonimir Stanečić  <zvonimirek222@yandex.com>\n"
 "Language-Team: \n"

doc/locales/pt/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2017-12-11 11:08-0600\n"
 "Last-Translator: \n"
 "Language-Team: \n"

doc/locales/pt/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2015-11-27 08:35-0600\n"
 "Last-Translator: Manuel Cortéz <manuel@manuelcortez.net>\n"
 "Language-Team: \n"

doc/locales/pt/manual.md

@@ -1,285 +0,0 @@
-% Documentação do TW Blue 0.42
-
-# Versão 0.42 (alpha)
-
-# ¡Perigro!
-
-Você está lendo um documento gerado para uma aplicação em fase de desenvolvimento. A intenção deste manual é esclarecer alguns detalhes sobre o funcionamento do programa. Note-se que sendo desenvolvido ativamente, o software pode mudar um pouco em relação a esta documentação num futuro próximo. Por isso é aconselhável dar uma olhada de vez em quando para não se perder muito.
-
-Si quieres ver lo que ha cambiado con respecto a la versión anterior, [lee la lista de novedades aquí.](changes.html)
-
-# TW Blue
-
-TW Blue é um aplicativo para utilizar o Twitter de forma simples e rápida, além de evitar tanto quanto possível consumir demasiados recursos do computador. Com ele   é possível realizar  ações do Twitter, tais como:
-
-* Crear, responder, reenviar y eliminar Tuits,
-* Marcar como favorito, eliminar de tus favoritos un tuit,
-* Enviar y eliminar mensajes directos,
-* Ver tus amigos y seguidores,
-* Seguir, dejar de seguir, reportar como spam y bloquear a un usuario,
-* Abrir una línea temporal para un usuario, lo que permite obtener todos los Tuits de ese usuario únicamente,
-* Abrir direcciones URL cuando vayan en un tuit o mensaje directo,
-* Reproducir varios tipos de archivos o direcciones que contengan audio.
-* Y más.
-
-# Tabla de contenidos
-
-Para poder utilizar una aplicación como TW Blue que te permita gestionar una cuenta de Twitter, primero tienes que  estar registrado en esta red social. Esta documentación no tiene como objetivo explicar el procedimiento para hacerlo. Partiremos desde el punto que tienes una cuenta con su respectivo nombre de usuario y contraseña. La documentación cubrirá estas secciones.
-
-* [Autorizar la aplicación](#autorizar)
-* [La interfaz del programa](#interfaz)
-* [Controles](#controles)
-    * [La interfaz gráfica (GUI)](#gui)
-        * [Botones de la aplicación](#botones)
-        * [Menús](#menus)
-            * [Menú aplicación](#app)
-            * [Menú Tuit](#tuit)
-            * [Menú Usuario](#usuario)
-            * [Menú buffer](#buffer)
-            * [Menú ayuda](#ayuda)
-    * [La interfaz No Visible](#interfaz_no_visible)
-    * [Atajos de Teclado para la Interfaz Gráfica](#atajos)
-    * [Atajos de Teclado para la Interfaz no Visible](#atajos_invisibles)
-* [Listas](#listas)
-* [Reportando Errores desde la web](#reportar)
-* [Contacto](#contacto)
-
-## Autorizando la aplicación {#autorizar}
-
-Antes de nada, lo primero que se necesita es autorizar al programa para que este pueda acceder a tu cuenta de Twitter, y desde ella realizar lo que le pidas. El proceso de autorización es bastante sencillo, y en ningún momento el programa podrá tener acceso a tus datos como usuario y contraseña. Para autorizar la aplicación, solo tienes que abrir el archivo principal del programa, llamado TW Blue.exe (en algunos PC, solo se muestra como TW Blue).
-
-Al hacerlo, si no has configurado ninguna vez el programa, se mostrará un cuadro de diálogo donde te informa que serás llevado a Twitter para autorizar la aplicación una vez pulses sobre "aceptar". Para empezar con el proceso de autorización presiona sobre el único botón de ese diálogo.
-
-A continuación, tu navegador predeterminado se abrirá con la página de Twitter solicitándote autorizar la aplicación. Escribe, si no estás autenticado ya, tu nombre de usuario y contraseña, luego busca el botón autorizar, y presiónalo.
-
-De la página a la que serás redirigido (si el proceso ha tenido éxito), busca las instrucciones que te proporciona Twitter. En resumen, te dará un código numérico de varios dígitos que deberás pegar en un cuadro de texto que la aplicación ha abierto en otra ventana.
-
-Pega el código de verificación, y pulsa la tecla Intro.
-
-Si todo ha salido bien, la aplicación empezará a reproducir un grupo de sonidos en señal que se están actualizando tus datos.
-
-Cuando termine, el programa reproducirá otro sonido, y el lector de pantalla dirá "listo".
-
-## La interfaz del programa {#interfaz}
-
-La forma más simple de describir la interfaz gráfica de la aplicación es la de una ventana con una barra de menú con cinco menús (aplicación, tuit, usuario, buffer y ayuda); una lista de varios elementos y en la mayoría de los casos tres botones. Tuit, retuit y responder. Las acciones para cada uno de estos elementos serán descritas más adelante.
-
-Los elementos que hay en las listas pueden ser Tuits, mensajes directos o usuarios. TW Blue crea diferentes pestañas para cada lista, pues estos elementos pueden ser Tuits enviados, Tuits recividos en la línea principal, favoritos, o mensajes directos, y cada pestaña tiene un solo tipo de Tuit. Estas pestañas se llaman listas o buffers.
-
-Para cambiar entre las listas se hace presionando Control+Tab si se desea avanzar, y Control+Shift+Tab para retroceder. En todo momento los lectores de pantalla anunciarán la lista hacia la que se cambie el foco de la aplicación. Aquí están las listas básicas de TW Blue, que aparecen si se usa la configuración por defecto.
-
-* Principal: Aquí van todos los Tuits que se muestran en la línea principal. Estos son los Tuits de los usuarios a los que sigues.
-* Menciones: Si un usuario (lo sigas o no) te menciona en Twitter, lo verás en esta lista.
-* Mensajes directos: Aquí están los mensajes directos (privados) que intercambias con los usuarios que sigues y te siguen. Esta lista solo muestra los mensajes recividos.
-* Enviados: En esta lista se muestran todos los Tuits y mensajes directos que se han enviado desde tu cuenta.
-* Favoritos: Aquí verás los Tuits que has marcado como favoritos.
-* Seguidores: Cuando los usuarios sigan tu cuenta, podrás verlos en esta lista, junto con un poco de información de la cuenta.
-* Amigos: Igual que la lista anterior, pero estos usuarios son a los que tú sigues.
-* Eventos: Un evento en TW Blue es "algo" que pase en Twitter. En la línea de eventos, podrás ver registrados los eventos más comunes (p. Ej. Te han comenzado a seguir, han marcado o removido un tweet tuyo de los favoritos, te has suscrito a una lista). Son como pequeñas notificaciones que envía Twitter y TW Blue organiza para que no te pierdas lo que ha pasado con tu cuenta.
-* Línea temporal de un usuario: Estas son listas que tú deberás crear. Es una lista que contiene únicamente los Tuits de un usuario. Se usan si algún día necesitas o quieres ver los Tuits que ha realizado solo una persona y no deseas buscar por todo tu timeline. Puedes crear tantas como usuarios necesites.
-* Lista: Una lista es parecida a una línea temporal, pero compuesta por los tweets de cada usuario que forme parte de ella. De momento las listas son una característica experimental de TW Blue. Si experimentas problemas con ellas, por favor escríbenos para contárnoslo.
-* Búsqueda: Un buffer de búsqueda contiene los resultados de una búsqueda hecha en TW Blue. Las búsquedas pueden ser por tuits, en cuyo caso buscas un término en los tuits relevantes de Twitter, o por usuarios, donde los resultados son nombres de usuario de Twitter.
-* Favoritos de un usuario: Es posible pedirle a TW Blue que te muestre los tuits que un usuario ha marcado como favoritos.
-
-Nota: Únicamente para esta versión de TW Blue, los amigos y seguidores actualizarán hasta 400, o cerca a los 400. En la próxima versión proporcionaremos un método para ver los amigos y seguidores sin exponerse tanto a los errores causados por el uso de la API de Twitter, muy frecuente entre personas con más de 600 amigos o seguidores.
-
-Ten en cuenta que por defecto la configuración solo permite obtener los 200 últimos Tuits para las listas principal, menciones, mensajes directos y líneas temporales. Esto puedes cambiarlo desde el diálogo de configuración. Para los enviados se obtendrán los últimos 200 Tuits y 200 mensajes directos. En versiones futuras se permitirá ajustar este parámetro.
-
-Si hay una dirección URL en algún tuit, TW Blue intentará abrirla cuando presiones Intro sobre ella. Si hay más de una, te mostrará una lista con todas para que selecciones la que quieras abrir. Si estás en el cuadro de diálogo de los amigos o seguidores,  la tecla intro te mostrará detalles del mismo.
-
-Si pulsas Control+Intro, TW Blue intentará reproducir el audio que tenga el tuit sobre el que está el foco del sistema, siempre que tenga una URL. Si el tuit lleva la etiqueta #audio, un sonido al pasar por él te alertará que es un audio y puedes intentar reproducirlo. No obstante, también puede que no esté etiquetado y que TW Blue pueda reproducirlo, siempre que lleve a una dirección URL donde exista audio.
-
-## Controles {#controles}
-
-A partir de la versión 0.36, existe soporte para una interfaz que no requiere de una ventana visible. Esta puede ser activada pulsando Control+m, o seleccionando desde el menú aplicación la opción "Esconder ventana". Esta interfaz se maneja completamente con atajos de teclado. Estos atajos son diferentes a los que se utilizan para la interfaz gráfica. Cada una de ellas podrá utilizar solo los atajos que le correspondan, lo que quiere decir que no se permitirá utilizar los atajos de la interfaz no visible si se tiene activada la interfaz gráfica. En esta sección se detallará tanto la interfaz gráfica como la no visible.
-
-### Interfaz gráfica (GUI) {#gui}
-
-Aquí una lista dividida en dos partes. Por un lado, los botones que encontrarás si presionas Tab o Shift+Tab en la interfaz del programa, y por otro, los diferentes elementos que hay en la barra de menú.
-
-#### Botones de la aplicación {#botones}
-
-* Twit: Este botón abre el diálogo para escribir un tuit. El mensaje solo debe tener 140 caracteres. Al escribir el caracter número 141, un sonido será reproducido para indicarte que te has pasado del límite permitido por Twitter. Puedes querer acortar o desacortar una URL si la incluye tu tuit a fin de ganar más espacio donde escribir, para eso están los botones con esos nombres. Pulsa Intro para enviar el tuit. Si todo sale bien, el mensaje se enviará y tú escucharás un sonido que te lo confirme, si no, el lector de pantalla te responderá con un error en inglés, que indica por qué no se ha podido enviar el mensaje.
-* Retuit: Este botón se encarga de reenviar el tuit sobre el que estás leyendo. Al presionarlo se te preguntará si deseas añadirle un comentario al tuit original (citándolo) o simplemente enviarlo como se ha escrito sin añadir nada más.
-* Responder: Cuando estés visualizando un Tuit, puedes responderle al usuario que lo escribió pulsando sobre este botón. Se abrirá el mismo diálogo de Tuit, pero con el nombre del usuario (por ejemplo @usuario) en el, para que solo escribas el mensaje que quieres responderle. Si en el tuit hay más de un usuario mencionado, pulsa Shift+Tab y pulsa el botón "Mencionar a todos los usuarios". Cuando estés en la lista de amigos o seguidores, este botón se llamará mencionar.
-* mensaje directo: Exactamente igual que enviar un Tuit, pero es un mensaje privado que solo podrá ver el usuario al que se lo envías. Pulsa Shift+Tab para ver el destinatario de tu mensaje. Si en el Tuit donde estabas para enviar el mensaje había más de un usuario mencionado, puedes navegar con las flechas de arriba y abajo para seleccionar otro, o escribir tú mismo el usuario (sin el signo de arroba).
-
-Ten en cuenta que los botones aparecerán según las acciones que se puedan hacer en la lista donde estés. Por ejemplo, en la línea principal, menciones, enviados, favoritos y las líneas temporales de los usuarios podrás ver los cuatro botones; mientras que en la lista de mensajes directos solo estará disponible el botón de "Mensaje Directo" y "tuit", y en las listas de amigos y seguidores, se verá el botón para "Twit" y el de "Mensaje directo" junto a "mencionar".
-
-#### Menús {#menus}
-
-En la parte superior de la ventana del programa podrás encontrar una barra de menú que hace las mismas cosas, y algunas cuantas más. A la barra de menú se accede presionando la tecla ALT, y cuenta en este momento con cuatro menús para diferentes acciones: Aplicación, Tuit, usuario y Ayuda. En esta sección se describen las acciones para cada uno de ellos.
-
-##### Menú aplicación {#app}
-
-* Actualizar Perfil: Abre un diálogo desde donde se podrá actualizar parte de tu información en Twitter. Nombre, ubicación, dirección URL y descripción. Si ya tienes alguno de estos campos actualmente en el perfil se llenarán automáticamente con lo que tiene tu configuración de Twitter. También podrás subir una foto a tu perfil.
-* Esconder Ventana: Desactiva la interfaz gráfica. Lee el apartado sobre la interfaz no visible para más detalles sobre este comportamiento.
-* Búsqueda: Muestra un cuadro de diálogo desde donde puedes buscar por tuits o por usuarios en twitter.
-* Gestor de listas: Para poder utilizar las listas de Twitter, primero necesitarás crearlas. Este diálogo permite ver tus listas, editarlas, crearlas, borrarlas y, opcionalmente, verlas en buffers tal como lo harías con las líneas temporales.
-* Tutorial de sonidos: Abre un diálogo donde verás una lista de los sonidos de TW blue, para que puedas aprenderlos y no te cueste trabajo familiarizarte con TW Blue.
-* Preferencias: Abre un diálogo de configuración desde donde se pueden controlar algunos aspectos del programa. Las opciones no necesitan de explicación.
-* Salir: pregunta si quieres salir o no del programa. Si la respuesta es que sí, cierra la aplicación.
-
-##### Menú Tuit {#tuit}
-
-* Las primeras opciones del menú son Twit, responder y retuit, que corresponden a los botones del mismo nombre.
-* Marcar como favorito: Marca el tuit que estés viendo como favorito.
-* Quitar tuit de favoritos: Elimina el tuit de tus favoritos. Esto no significa que se borra de Twitter, solo deja de estar en tu lista de favoritos.
-* Ver Tuit: Abre un diálogo donde puedes ver el Tuit, mensaje directo, amigo o seguidor sobre el que esté el foco de la aplicación. Puedes leer el texto con los cursores. El diálogo es el mismo que el que se usa para escribir un Tuit.
-* Eliminar: Elimina el Tuit o mensaje directo sobre el que estés, borrándolo definitivamente de Twitter y qitándolo de tus listas. Ten en cuenta que en el caso de los Tuits, Twitter solo permite borrar los que tú mismo has escrito.
-
-##### Menú usuario {#usuario}
-
-Ten en cuenta que las primeras seis opciones de este menú abren un mismo diálogo. Este diálogo tiene un cuadro de edición donde puedes seleccionar el usuario sobre el que deseas actuar, bien con los cursores arriba y abajo o escribiendo tú mismo el nombre. Después, hay un grupo de botones de radio para seguir, dejar de seguir, silenciar, des-silenciar, reportar como Spam y bloquear. Si seleccionas desde el menú la opción seguir, el botón del cuadro de diálogo estará marcado con esa opción, así como sucederá respectivamente con dejar de seguir, reportar como Spam y bloquear. Pulsa el botón Aceptar para que el programa trate de hacer lo que le pides. Si no se ha podido, escucharás el error en inglés.
-
-A continuación se describen las opciones restantes para este menú:
-
-* Mensaje Directo: La misma acción que el botón.
-* Añadir a lista: Para que puedas ver los tweets de un usuario en tus listas, primero hay que añadirlo. Esta opción abrirá un diálogo desde donde puedes seleccionar al usuario que deseas añadir, para después abrir otra ventana donde puedes seleccionar la lista a la cual añadir a ese usuario. Una vez hecho esto, la lista contendrá un nuevo usuario y podrás ver sus tweets.
-* Ver Perfil del usuario: Abre un diálogo desde donde te permite seleccionar el usuario al que quieres ver el perfil.
-* Línea temporal: Abre un diálogo desde donde puedes seleccionar el usuario para el que se creará la línea temporal. Al presionar intro, se creará. Si se hace una línea temporal de un usuario que no tenga Tuits, el programa fallará. Si se crea una línea que ya existe el programa te avisará y no permitirá crearla de nuevo.
-* Ver favoritos: Abre un buffer para seguir los favoritos que marca el usuario seleccionado.
-
-##### Menú Buffer {#buffer}
-
-* Silenciar: Silencia completamente el buffer, con lo que no escucharás sonido alguno cuando nuevos elementos aparezcan.
-* Leer automáticamente tuits para este buffer: Esta opción activa o desactiva la lectura automática de tuits. Si está activada, el lector de pantalla o la voz Sapi5 (si está activada una) leerá automáticamente los nuevos tuits conforme estos vayan llegando al buffer.
-* Limpiar Buffer: Vacía los elementos de este buffer.
-* Eliminar buffer: Borra la lista sobre la que te encuentras actualmente.
-
-##### Menú Ayuda {#ayuda}
-
-* Documentación: Abre este archivo, donde puedes leer algunos conceptos interesantes del programa.
-* ¿Qué hay de nuevo en esta versión?: Abre un documento con la lista de cambios desde la versión actual, hasta la primera en existencia.
-* Buscar actualizaciones: Cada que se abre el programa él mismo busca automáticamente si hay una nueva versión. Si lo hay, te preguntará si quieres descargarla; si aceptas, TW Blue descargará la actualización, la instalará y te pedirá reiniciarla (algo que hace automáticamente). Esta opción comprueba si hay actualizaciones sin tener que reiniciar la aplicación.
-* Sitio web de TW Blue. Ve a  nuestra [página principal](http://twblue.com.mx) donde podrás encontrar toda la información y descargas relativas a TW Blue, así como participar de la comunidad.
-* Reportar un error: Lanza un diálogo desde donde puedes reportar un error solo llenando un par de campos. El título y una pequeña descripción de lo que pasó. Al pulsar en "enviar" el error se reportará. Si no se ha podido el programa te mostrará un mensaje informándolo.
-* Sobre TW Blue: Muestra información de créditos del programa.
-
-### Interfaz no visible {#interfaz_no_visible}
-
-Si presionas Control+M, o si desde el menú aplicación seleccionas esconder ventana, estarás activando una interfaz a la que no se podrá acceder por la manera convencional, porque no se ve. 
-
-En la interfaz no visible todo lo que hagas será mediante atajos de teclado, incluso para recorrer las listas. Eventualmente se abrirán diálogos y estos sí serán visibles, pero la ventana principal de la aplicación no. Ve a la sección de atajos de teclado de la interfaz no visible para saber cuales puedes usar de momento.
-
-### Atajos de teclado para la Interfaz Gráfica {#atajos}
-
-Además de los botones y menús, la mayoría de las acciones pueden hacerse presionando una combinación de teclado. Aquí están las existentes en este momento:
-
-* Intro: Abrir una dirección URL. Si hay más de una podrás ver una lista que te permitirá seleccionar la que quieras. Si estás en la lista de amigos o seguidores, mostrará detalles del seleccionado.
-* Control+Intro: Intenta reproducir un audio si en el Tuit hay una dirección URL. 
-* F5: Baja un 5% el volumen de los sonidos. Esto afecta a los sonidos que reproduce el programa y al audio que puedas escuchar a través de él.
-* F6: Sube un 5% el volumen de los sonidos de la aplicación.
-* Control+N: Abre el diálogo para escribir un nuevo Tuit.
-* Control+M: Oculta la ventana.
-* Control+Q: Sale de la aplicación.
-* Control+R: Abre el diálogo para responder.
-* Control+Shift+R: Equivalente a la acción Retuit.
-* Control+D: Enviar mensaje directo.
-* Control+F: Marcar como favorito.
-* Control+Shift+F: Quitar de favoritos.
-* Control+Shift+V: Ver Tuit.
-* Control+S: Seguir a un usuario.
-* Control+Shift+S: Dejar de seguir a un usuario.
-* Control+K: Bloquear a un usuario.
-* Control+Shift+K: Reportar como Spam.
-* Control+I: Abrir línea temporal a un usuario.
-* Control+Shift+I: Eliminar línea temporal.
-* Control+p: Editar tu perfil.
-* Suprimir: Eliminar tuit o mensaje directo.
-* Shift+suprimir: vacía el buffer, quitando todos los elementos hasta ese entonces. Esto ocurre sin borrar nada de Twitter.
-
-### Atajos de teclado para la Interfaz no Visible {#atajos_invisibles}
-
-Estos son los atajos de teclado que puedes usar desde la interfaz no visible. Ten en cuenta que cuando la vista de la interfaz gráfica esté activada ninguno de ellos podrá usarse. Al decir "windows", nos estamos refiriendo a la tecla de Windows izquierda.
-
-* Control+Windows+Flecha Arriba: Va arriba en la lista actual.
-* Control+Windows+Flecha abajo: Va hacia abajo en la lista actual.
-* Control+Windows+Izquierda: Se desplaza a la pestaña de la izquierda.
-* Control+Windows+Derecha: Se desplaza hacia la pestaña de la derecha.
-* Control+Windows+Inicio: Ir al primer elemento de la lista.
-* Control+Windows+Fin: Ir al final de la lista.
-* Control+Windows+Avance de página: Ir 20 elementos hacia abajo en la lista actual.
-* Control+Windows+Retroceso de página: ir 20 elementos hacia arriba en la lista actual.
-* Control+Windows+Alt+Flecha Arriba: Subir volumen un 5%.
-* Control+Windows+Alt+Flecha Abajo: Bajar volumen un 5%.
-* Control+Windows+Intro: Abrir URL en el tuit, o ver detalles del usuario si estás en la lista de amigos o seguidores.
-* Control+Windows+Alt+Intro: Intentar reproducir un audio.
-* Control+Windows+M: Muestra la interfaz gráfica, desactivando la no visible.
-* Control+Windows+N: Hacer un nuevo Tuit.
-* Control+Windows+R: Responder a un tuit.
-* Control+Windows+Shift+R: Hacer un retuit.
-* Control+Windows+D: Enviar un mensaje directo.
-* Control+Windows+Suprimir: Eliminar un tuit o mensaje directo.
-* control+win+Shift+suprimir: vacía el buffer, quitando todos los elementos hasta ese entonces. Esto ocurre sin borrar nada de Twitter.
-* Windows+Alt+F: Marcar como favorito.
-* Windows+Alt+Shift+F: Quitar de favoritos.
-* Control+Windows+S: Seguir a un usuario.
-* Control+Windows+Shift+S: Dejar de seguir a alguien.
-* Control+Windows+Alt+N: Ver detalles de un usuario,
-* Control+Windows+V: Ver tuit en un cuadro de texto.
-* Control+Windows+I: Abrir línea temporal.
-* Control+Windows+Shift+I: Eliminar línea temporal de un usuario.
-* Alt+Windows+P: Editar tu perfil.
-* Control+win+espacio: ver tweet actual.
-* Control+win+c: Copiar tweet al portapapeles.
-* Control+windows+a: Añadir a un usuario a la lista.
-* Control+shift+windows+a: qitar de la lista.
-* Control+Windows+Shift+Flecha arriba: Ir un tuit hacia arriba en la conversación.
-* Control+Windows+Flecha Abajo: Ir un tuit hacia abajo en la conversación.
-* Control+Windows+Shift+M: Activar o desactivar el sonido para el buffer actual.
-* Windows+Alt+M: Activar o desactivar el silencio global de TW Blue.
-* Control+Windows+E: Activar o desactivar la lectura automática de los tuits en el buffer actual.
-* Control+windows+Guion: buscar en Twitter.
-* Control+Windows+F4: Cerrar el programa.
-
-## Listas {#listas}
-
-Una de las características más interesantes de Twitter son las listas, ya que son una manera de mantenerse actualizado sin tener que leer los tweets de todos los usuarios a los que sigues. Con una lista de Twitter solo verás los tweets de sus miembros (la gente que está dentro de la lista). Es parecido a una línea temporal, pero para muchos más usuarios.
-
-En TW blue hemos empezado a dar soporte para esta característica. De momento vamos poco a poco, pero ya es posible usar esta función. Te presentamos los pasos que hay que dar para poder tener una lista abierta en TW Blue.
-
-* Primero necesitarás ir al gestor de listas, ubicado bajo el menú aplicación.
-* en el gestor de listas podrás ver todas las listas a las que estás unido, empezando por las que tú has creado. Si no ves ninguna lista en este diálogo, significa que no has creado ni te has unido a ninguna lista. Está bien.
-* Verás un grupo de botones que se explican por sí solos: Crear nueva lista, editar, eliminar, abrir en buffer (este quizá es el menos claro, se refiere a abrir un nuevo buffer para que TW Blue actualice los tweets de la lista, como cuando pasa con las líneas temporales).
-
-Una vez que hayas creado una nueva lista, no deberías abrirla en buffer. Al menos no de inmediato, porque en este momento no tiene miembro alguno y eso significa que cuando se carguen los tweets para empezar a actualizarla no verás nada. Es recomendable primero añadir a gente a la lista, tal como sigue:
-
-* Cuando hayas cerrado el gestor de listas y estés navegando por entre los tweets de los usuarios, busca el usuario al que quieres añadir a la lista.
-* Una vez encontrado, presiona el atajo Ctrl+Win+A o ve al menú usuario y selecciona la opción "Añadir a lista".
-* Lo siguiente que verás es un diálogo que te permitirá seleccionar el usuario, asegúrate que el que está como predeterminado es el que deseas, o cámbialo si es necesario, y presiona Aceptar.
-* Ahora verás otro diálogo, pero aquí están todas tus listas. Selecciona una (simplemente lleva el cursor hacia ella), y presiona el botón añadir.
-* Para qitar a un usuario de una lista repite el mismo proceso, pero presiona Control+Win+Shift+A o selecciona la opción "Quitar de lista", y en el diálogo de las listas presiona sobre el botón "remover".
-
-## Reportando Errores Desde la Web {#reportar}
-
-Nota: Si estás usando el programa también puedes reportar un error desde el mismo, usando para ello la opción del menú ayuda. Este proceso solo te pide llenar dos cuadros de edición, y se encarga del resto. Estos pasos están escritos para quienes no pueden abrir el programa, no lo tienen en uso en este momento o sencillamente quieran reportar desde la web en lugar del sistema integrado de reporte de errores.
-
-Las cosas en este mundo (sí, incluidos los programas informáticos) están muy lejos de ser perfectas, con lo que a menudo te encontrarás con errores no previstos en la aplicación. Pero como la intención es siempre mejorar, eres libre (es más, sería genial que lo hicieras) de reportar los errores que vayas encontrando del programa para que se puedan revisar y eventualmente corregir.
-
-Para entrar a la web de reporte de incidencias, sigue [Este enlace.](http://twblue.com.mx/errores/bug_report_page.php) Es una web con un formulario donde tienes que llenar varios campos. Solo tres de ellos son realmente obligatorios (los que tienen marcado un asterisco), pero entre más campos puedas llenar, será mejor.
-
-Aquí están los diferentes campos del formulario y lo que deberías introducir en cada uno de ellos. Recuerda que son obligatorios solamente los campos marcados con un asterisco (*):
-
-* Categoría: Este cuadro combinado permite seleccionar a qué categoría asignar el error. Puede ser a la categoría General, si es un error del programa, o a documentación, si has encontrado un error en este archivo o en la lista de cambios. Este campo es obligatorio.
-* Reproducibilidad: Aquí deberías indicar qué tan fácil o no es de reproducir el error. Las opciones disponibles son Desconocido, No reproducible, No se ha intentado (por defecto), aleatorio, a veces o siempre. Dependiendo de si se puede reproducir el error o no, deberías indicar lo que se parezca más a tu caso. Si estás solicitando una nueva funcionalidad, no importa este cuadro combinado.
-* Severidad: Aquí se selecciona que tanto afecta esto al programa. Las opciones disponibles son funcionalidad (selecciona esto para solicitar una nueva funcionalidad), Trivial, Texto, Ajuste, Menor, Mayor, fallo o bloqueo. Nota que las opciones aumentan de nivel. Selecciona lo que más creas. Si no estás seguro de que seleccionar puedes dejarlo como está.
-* Prioridad: En este cuadro se selecciona la opción de acuerdo con la importancia del error o funcionalidad solicitada. Las opciones disponibles son Ninguna, baja, normal, alta, hurgente e inmediata.
-* Seleccionar Perfil: Aquí puedes escojer entre la configuración de arquitectura (32 o 64 bits), y el sistema operativo (Windows siete de momento). Si no, puedes llenar los tres cuadros de edición que están en la siguiente tabla con tus datos en específico.
-* Versión del producto: Selecciona la versión del programa que estás utilizando para poder averiguar donde se ha generado el error. Este cuadro combinado tendrá la lista de las versiones en orden. Si bien no es obligatorio, ayudaría mucho a resolver más rápidamente el error.
-* Resumen: Un título para el error, que explique en pocas palabras qué ocurre. Es un cuadro de texto obligatorio.
-* Descripción: Este campo también obligatorio, te pide que describas con más detalles qué fue lo que ha ocurrido con el programa.
-* Pasos para reproducir: Este campo de texto te sirve si sabes como hacer que la aplicación genere el error. Esto no es obligatorio, pero ayudaría mucho conocer como hacer que el programa tenga este error para rastrearlo mejor.
-* Información adicional: Si tienes un comentario o nota que añadir, aquí puede ir. No es obligatorio.
-* Subir archivo: Puedes subir aquí el archivo TW Blue.exe.log que se creó con el error que el programa tuvo. No es obligatorio.
-* Visibilidad: Selecciona si quieres que el error sea público o privado. Por defecto es público, y es recomendable que así continúe.
-* Enviar reporte. Presiona aquí para publicar el error y que este sea atendido.
-
-Muchas gracias por participar reportando errores y probando las funciones nuevas.
-
-## Contacto {#contacto}
-
-Si lo que se expone en este documento no es suficiente, si deseas colaborar de alguna otra forma o si simplemente deseas mantenerte en contacto con quien hace esta aplicación, sigue a la cuenta [@tw_blue2](https://twitter.com/tw_blue2) o a [@manuelcortez00.](https://twitter.com/manuelcortez00) También puedes visitar nuestro [Sitio web](http://twblue.com.mx)
-
----
-Copyright © 2013-2014. Manuel Cortéz.

doc/locales/ro/LC_MESSAGES/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 10:27+0300\n"
 "Last-Translator: Florian Ionașcu <florianionascu@hotmail.com>\n"
 "Language-Team: \n"

doc/locales/ro/LC_MESSAGES/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: twblue-documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-08 10:32+0300\n"
 "Last-Translator: Florian Ionașcu <florianionascu@hotmail.com>\n"
 "Language-Team: Spanish <manuel@manuelcortez.net>\n"

doc/locales/ru/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-15 12:20+0400\n"
 "Last-Translator: Наталья Хедлунд <natalia.hedlund@gmail.com>\n"
 "Language-Team: \n"

doc/locales/ru/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-08-14 21:44+0400\n"
 "Last-Translator: Valeria <luciana.lu3a@gmail.com>\n"
 "Language-Team: \n"

doc/locales/tr/lc_messages/twblue-changelog.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2018-01-05 17:01+0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"

doc/locales/tr/lc_messages/twblue-documentation.po

@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: TW Blue documentation 0.46\n"
-"POT-Creation-Date: 2019-03-17 13:34+Hora estndar romance\n"
+"POT-Creation-Date: 2019-03-17 13:34\n"
 "PO-Revision-Date: 2019-02-03 17:01+0300\n"
 "Last-Translator: Manuel Cortéz <manuel@manuelcortez.net>\n"
 "Language-Team: \n"

doc/manual.md

@@ -1,4 +1,4 @@
-Documentation for TWBlue - 0.88
+Documentation for TWBlue
 
 ## Table of contents
 
@@ -42,7 +42,7 @@ You can log into several Twitter accounts simultaneously. The program refers to
 
 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. 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.
+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.
 
@@ -56,7 +56,7 @@ Before starting to describe TWBlue's usage, we'll explain some concepts that wil
 
 ### 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 events. According to the buffer you are focusing, you will be able to do different actions with these items.
+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.
 
@@ -69,17 +69,17 @@ The following is a description for every one of TWBlue's buffers and the kind of
 * 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.
-* 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 likes 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.
 * 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 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.
+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 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.
+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
 
@@ -98,9 +98,9 @@ In summary, the GUI contains two core components. These are the controls you wil
 
 #### 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 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 + 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.
+* 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. When you're on the friends or followers lists, the button will be called mention instead.
+* 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.
@@ -116,6 +116,7 @@ Visually, Towards the top of the main application window, can be found a menu ba
 * 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.
@@ -145,6 +146,7 @@ Visually, Towards the top of the main application window, can be found a menu ba
  * 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.
@@ -153,8 +155,12 @@ Visually, Towards the top of the main application window, can be found a menu ba
 
 ##### 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.
@@ -173,6 +179,8 @@ Visually, Towards the top of the main application window, can be found a menu ba
 * 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
@@ -350,4 +358,4 @@ Many thanks also to the people who worked on the documentation. Initially, [Manu
 
 ------------------------------------------------------------------------
 
-Copyright © 2013-2017. Manuel Cortéz
+Copyright © 2013-2021. 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

requirements.txt

@@ -9,27 +9,46 @@ oauthlib
 requests-oauthlib
 requests-toolbelt
 pypubsub
-pygeocoder
+geopy
 arrow
 python-dateutil
 futures
 winpaths
 PySocks
 win_inet_pton
-yandex.translate
+# 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
-git+https://github.com/manuelcortez/libloader
-git+https://github.com/manuelcortez/platform_utils
-git+https://github.com/manuelcortez/accessible_output2
-git+https://github.com/jmdaweb/sound_lib
+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

@@ -14,11 +14,11 @@ SetCompress auto
 SetCompressor /solid lzma
 SetDatablockOptimize on
 VIAddVersionKey ProductName "TWBlue"
-VIAddVersionKey LegalCopyright "Copyright 2018 Manuel Cortéz."
-VIAddVersionKey ProductVersion "0.95"
-VIAddVersionKey FileVersion "0.95"
-VIProductVersion "0.95.0.0"
-VIFileVersion "0.95.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"
@@ -27,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"
@@ -73,9 +73,9 @@ WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "U
 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.95"
-WriteRegStr HKLM "Software\Microsoft\Windows\CurrentVersion\Uninstall\twblue" "URLInfoAbout" "http://twblue.es"
+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" 95
+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

@@ -12,6 +12,7 @@ reverse_timelines = boolean(default=False)
 announce_stream_status = boolean(default=True)
 retweet_mode = string(default="ask")
 persist_size = integer(default=0)
+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'))
 
@@ -20,7 +21,7 @@ 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)
@@ -48,3 +49,5 @@ braille_reporting = boolean(default=True)
 speech_reporting = boolean(default=True)
 
 [filters]
+
+[user-aliases]

src/application.py

@@ -3,20 +3,14 @@ import datetime
 
 name = 'TWBlue'
 short_name='twblue'
-snapshot = True
-if snapshot == False:
- version = "0.95"
- update_url = 'https://twblue.es/updates/stable.php'
- mirror_update_url = 'https://raw.githubusercontent.com/manuelcortez/TWBlue/next-gen/updates/stable.json'
-else:
- version = "3"
- update_url = 'https://twblue.es/updates/snapshot.php'
- mirror_update_url = 'https://raw.githubusercontent.com/manuelcortez/TWBlue/next-gen/updates/snapshots.json'
+update_url = 'https://twblue.es/updates/updates.php'
+mirror_update_url = 'https://raw.githubusercontent.com/manuelcortez/TWBlue/next-gen/updates/updates.json'
 authors = ["Manuel Cortéz", "José Manuel Delicado"]
 authorEmail = "manuel@manuelcortez.net"
-copyright = "Copyright (C) 2013-2018, Manuel cortéz."
+copyright = "Copyright (C) 2013-2021, Manuel cortéz."
 description = 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 = ["Manuel Cortéz (English)", "Mohammed Al Shara, Hatoun Felemban (Arabic)", "Francisco Torres (Catalan)", "Manuel cortéz (Spanish)", "Sukil Etxenike Arizaleta (Basque)", "Jani Kinnunen (finnish)", "Rémy Ruiz (French)", "Juan Buño (Galician)", "Steffen Schultz (German)", "Zvonimir Stanečić (Croatian)", "Robert Osztolykan (Hungarian)", "Christian Leo Mameli (Italian)", "Riku (Japanese)", "Paweł Masarczyk (Polish)", "Odenilton Júnior Santos (Portuguese)", "Florian Ionașcu, Nicușor Untilă (Romanian)", "Natalia Hedlund, Valeria Kuznetsova (Russian)", "Aleksandar Đurić (Serbian)", "Burak Yüksek (Turkish)"]
+translators = ["Manuel Cortéz (English)", "Mohammed Al Shara, Hatoun Felemban (Arabic)", "Francisco Torres (Catalan)", "Manuel cortéz (Spanish)", "Sukil Etxenike Arizaleta (Basque)", "Jani Kinnunen (finnish)", "Oreonan (Français)", "Juan Buño (Galician)", "Steffen Schultz (German)", "Zvonimir Stanečić (Croatian)", "Robert Osztolykan (Hungarian)", "Christian Leo Mameli (Italian)", "Riku (Japanese)", "Paweł Masarczyk (Polish)", "Odenilton Júnior Santos (Portuguese)", "Florian Ionașcu, Nicușor Untilă (Romanian)", "Natalia Hedlund, Valeria Kuznetsova (Russian)", "Aleksandar Đurić (Serbian)", "Burak Yüksek (Turkish)"]
 url = u"https://twblue.es"
 report_bugs_url = "https://github.com/manuelcortez/twblue/issues"
-supported_languages = []
+supported_languages = []
+version = "11"

src/audio_services/__init__.py

@@ -2,22 +2,22 @@ from __future__ import unicode_literals
 from functools import wraps
 
 def matches_url(url):
- def url_setter(func):
-  @wraps(func)
-  def internal_url_setter(*args, **kwargs):
-   return func(*args, **kwargs)
-  internal_url_setter.url = url
-  return internal_url_setter
- return url_setter
+    def url_setter(func):
+        @wraps(func)
+        def internal_url_setter(*args, **kwargs):
+            return func(*args, **kwargs)
+        internal_url_setter.url = url
+        return internal_url_setter
+    return url_setter
 
 def find_url_transformer(url):
- from audio_services import services
- funcs = []
- for i in dir(services):
-  possible = getattr(services, i)
-  if callable(possible) and hasattr(possible, 'url'):
-   funcs.append(possible)
- for f in funcs:
-  if url.lower().startswith(f.url.lower()):
-   return f
- return services.convert_generic_audio
+    from audio_services import services
+    funcs = []
+    for i in dir(services):
+        possible = getattr(services, i)
+        if callable(possible) and hasattr(possible, 'url'):
+            funcs.append(possible)
+    for f in funcs:
+        if url.lower().startswith(f.url.lower()):
+            return f
+    return services.convert_generic_audio

src/audio_services/services.py

@@ -5,37 +5,37 @@ from . import youtube_utils
 
 @matches_url('https://audioboom.com')
 def convert_audioboom(url):
- if "audioboom.com" not in url.lower():
-  raise TypeError('%r is not a valid URL' % url)
- audio_id = url.split('.com/')[-1]
- return 'https://audioboom.com/%s.mp3' % audio_id
+    if "audioboom.com" not in url.lower():
+        raise TypeError('%r is not a valid URL' % url)
+    audio_id = url.split('.com/')[-1]
+    return 'https://audioboom.com/%s.mp3' % audio_id
 
 @matches_url ('https://soundcloud.com/')
 def convert_soundcloud (url):
- client_id = "df8113ca95c157b6c9731f54b105b473"
- with requests.get('http://api.soundcloud.com/resolve.json', client_id=client_id, url=url) as permalink:
-  if permalink.status_code==404:
-   raise TypeError('%r is not a valid URL' % permalink.url)
-  else:
-   resolved_url = permalink.url
- with requests.get(resolved_url) as track_url:
-  track_data = track_url.json()
+    client_id = "df8113ca95c157b6c9731f54b105b473"
+    with requests.get('http://api.soundcloud.com/resolve.json', client_id=client_id, url=url) as permalink:
+        if permalink.status_code==404:
+            raise TypeError('%r is not a valid URL' % permalink.url)
+        else:
+            resolved_url = permalink.url
+    with requests.get(resolved_url) as track_url:
+        track_data = track_url.json()
 
- if track_data ['streamable']:
-  return track_data ['stream_url'] + "?client_id=%s" %client_id
- else:
-  raise TypeError('%r is not streamable' % url)
+    if track_data ['streamable']:
+        return track_data ['stream_url'] + "?client_id=%s" %client_id
+    else:
+        raise TypeError('%r is not streamable' % url)
 
 @matches_url ('https://www.youtube.com/watch')
 def convert_youtube_long (url):
- return youtube_utils.get_video_url(url)
+    return youtube_utils.get_video_url(url)
 
 @matches_url ('http://anyaudio.net/listen')
 def convert_anyaudio(url):
- values = url.split("audio=")
- if len(values) != 2:
-  raise TypeError('%r is not streamable' % url)
- return "http://anyaudio.net/audiodownload?audio=%s" % (values[1],)
+    values = url.split("audio=")
+    if len(values) != 2:
+        raise TypeError('%r is not streamable' % url)
+    return "http://anyaudio.net/audiodownload?audio=%s" % (values[1],)
 
 def convert_generic_audio(url):
- return url
+    return url

src/audio_services/youtube_utils.py

@@ -3,11 +3,11 @@ from __future__ import unicode_literals
 import youtube_dl
 
 def get_video_url(url):
- ydl = youtube_dl.YoutubeDL({'quiet': True, 'format': 'bestaudio/best', 'outtmpl': u'%(id)s%(ext)s'})
- with ydl:
-  result = ydl.extract_info(url, download=False)
- if 'entries' in result:
-  video = result['entries'][0]
- else:
-  video = result
- return video["formats"][0]["url"]
+    ydl = youtube_dl.YoutubeDL({'quiet': True, 'format': 'bestaudio/best', 'outtmpl': u'%(id)s%(ext)s'})
+    with ydl:
+        result = ydl.extract_info(url, download=False)
+    if 'entries' in result:
+        video = result['entries'][0]
+    else:
+        video = result
+    return video["formats"][0]["url"]

src/config.py

@@ -15,14 +15,14 @@ keymap=None
 changed_keymap = False
 
 def setup ():
- global app
- log.debug("Loading global app settings...")
- app = config_utils.load_config(os.path.join(paths.config_path(), MAINFILE), os.path.join(paths.app_path(), MAINSPEC))
- log.debug("Loading keymap...")
- global keymap
- if float(platform.version()[:2]) >= 10 and app["app-settings"]["load_keymap"] == "default.keymap":
-  app["app-settings"]["load_keymap"] = "Windows 10.keymap"
-  app.write()
-  global changed_keymap
-  changed_keymap = True
- keymap = config_utils.load_config(os.path.join(paths.config_path(), "keymap.keymap"), os.path.join(paths.app_path(), "keymaps/"+app['app-settings']['load_keymap']), copy=False)
+    global app
+    log.debug("Loading global app settings...")
+    app = config_utils.load_config(os.path.join(paths.config_path(), MAINFILE), os.path.join(paths.app_path(), MAINSPEC))
+    log.debug("Loading keymap...")
+    global keymap
+    if float(platform.version()[:2]) >= 10 and app["app-settings"]["load_keymap"] == "default.keymap":
+        app["app-settings"]["load_keymap"] = "Windows 10.keymap"
+        app.write()
+        global changed_keymap
+        changed_keymap = True
+    keymap = config_utils.load_config(os.path.join(paths.config_path(), "keymap.keymap"), os.path.join(paths.app_path(), "keymaps/"+app['app-settings']['load_keymap']), copy=False)

src/config_utils.py

@@ -10,70 +10,70 @@ log = getLogger("config_utils")
 class ConfigLoadError(Exception): pass
 
 def load_config(config_path, configspec_path=None, copy=True, *args, **kwargs):
- spec = ConfigObj(configspec_path, encoding='UTF8', list_values=False, _inspec=True)
- try:
-  config = ConfigObj(infile=config_path, configspec=spec, create_empty=True, encoding='UTF8', *args, **kwargs)
- except ParseError:
-  raise ConfigLoadError("Unable to load %r" % config_path)
- validator = Validator()
- validated = config.validate(validator, preserve_errors=False, copy=copy)
- if validated == True:
-  config.write()
-  return config
- else:
-  log.exception("Error in config file: {0}".format(validated,))
-  commonMessageDialogs.invalid_configration()
+    spec = ConfigObj(configspec_path, encoding='UTF8', list_values=False, _inspec=True)
+    try:
+        config = ConfigObj(infile=config_path, configspec=spec, create_empty=True, encoding='UTF8', *args, **kwargs)
+    except ParseError:
+        raise ConfigLoadError("Unable to load %r" % config_path)
+    validator = Validator()
+    validated = config.validate(validator, preserve_errors=False, copy=copy)
+    if validated == True:
+        config.write()
+        return config
+    else:
+        log.exception("Error in config file: {0}".format(validated,))
+        commonMessageDialogs.invalid_configuration()
 
 def is_blank(arg):
- "Check if a line is blank."
- for c in arg:
-  if c not in string.whitespace:
-   return False
- return True
+    "Check if a line is blank."
+    for c in arg:
+        if c not in string.whitespace:
+            return False
+    return True
 
 def get_keys(path):
- "Gets the keys of a configobj config file."
- res=[]
- fin=open(path)
- for line in fin:
-  if not is_blank(line):
-   res.append(line[0:line.find('=')].strip())
- fin.close()
- return res
+    "Gets the keys of a configobj config file."
+    res=[]
+    fin=open(path)
+    for line in fin:
+        if not is_blank(line):
+            res.append(line[0:line.find('=')].strip())
+    fin.close()
+    return res
 
 def hist(keys):
- "Generates a histogram of an iterable."
- res={}
- for k in keys:
-  res[k]=res.setdefault(k,0)+1
- return res
+    "Generates a histogram of an iterable."
+    res={}
+    for k in keys:
+        res[k]=res.setdefault(k,0)+1
+    return res
 
 def find_problems(hist):
- "Takes a histogram and returns a list of items occurring more than once."
- res=[]
- for k,v in hist.items():
-  if v>1:
-   res.append(k)
- return res
+    "Takes a histogram and returns a list of items occurring more than once."
+    res=[]
+    for k,v in hist.items():
+        if v>1:
+            res.append(k)
+    return res
 
 def clean_config(path):
- "Cleans a config file. If duplicate values are found, delete all of them and just use the default."
- orig=[]
- cleaned=[]
- fin=open(path)
- for line in fin:
-  orig.append(line)
- fin.close()
- for p in find_problems(hist(get_keys(path))):
-  for o in orig:
-   o.strip()
-   if p not in o:
-    cleaned.append(o)
- if len(cleaned) != 0:
-  cam=open(path,'w')
-  for c in cleaned:
-   cam.write(c)
-  cam.close()
-  return True
- else:
-  return False
+    "Cleans a config file. If duplicate values are found, delete all of them and just use the default."
+    orig=[]
+    cleaned=[]
+    fin=open(path)
+    for line in fin:
+        orig.append(line)
+    fin.close()
+    for p in find_problems(hist(get_keys(path))):
+        for o in orig:
+            o.strip()
+            if p not in o:
+                cleaned.append(o)
+    if len(cleaned) != 0:
+        cam=open(path,'w')
+        for c in cleaned:
+            cam.write(c)
+        cam.close()
+        return True
+    else:
+        return False

src/controller/attach.py

@@ -1,40 +0,0 @@
-# -*- coding: utf-8 -*-
-from __future__ import unicode_literals
-from builtins import object
-import os
-import widgetUtils
-import logging
-from wxUI.dialogs import attach as gui
-log = logging.getLogger("controller.attach")
-
-class attach(object):
-	def __init__(self):
-		self.attachments = list()
-		self.dialog = gui.attachDialog()
-		widgetUtils.connect_event(self.dialog.photo, widgetUtils.BUTTON_PRESSED, self.upload_image)
-		widgetUtils.connect_event(self.dialog.remove, widgetUtils.BUTTON_PRESSED, self.remove_attachment)
-		self.dialog.get_response()
-		log.debug("Attachments controller started.")
-
-	def upload_image(self, *args, **kwargs):
-		image, description  = self.dialog.get_image()
-		if image != None:
-			imageInfo = {"type": "photo", "file": image, "description": description}
-			log.debug("Image data to upload: %r" % (imageInfo,))
-			self.attachments.append(imageInfo)
-			info = [_(u"Photo"), description]
-			self.dialog.attachments.insert_item(False, *info)
-			self.dialog.remove.Enable(True)
-
-	def remove_attachment(self, *args, **kwargs):
-		current_item = self.dialog.attachments.get_selected()
-		log.debug("Removing item %d" % (current_item,))
-		if current_item == -1: current_item = 0
-		self.attachments.pop(current_item)
-		self.dialog.attachments.remove_item(current_item)
-		self.check_remove_status()
-		log.debug("Removed")
-
-	def check_remove_status(self):
-		if len(self.attachments) == 0 and self.dialog.attachments.get_count() == 0:
-			self.dialog.remove.Enable(False)

src/controller/buffers/__init__.py

@@ -1,8 +1,3 @@
 # -*- coding: utf-8 -*-
-""" this package contains logic related to buffers. A buffer is a virtual representation of a group of items retrieved through the Social network API'S.
-  Ideally, new social networks added to TWBlue will have its own "buffers", and these buffers should be defined within this package, following the Twitter example.
-  Currently, the package contains the following modules:
-    * baseBuffers: Define a set of functions and structure to be expected in all buffers. New buffers should inherit its classes from one of the classes present here.
-    * twitterBuffers: All other code, specific to Twitter.
-"""
-from __future__ import unicode_literals
+from . import base as base
+from . import twitter as twitter

src/controller/buffers/base/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+from .account import AccountBuffer
+from .base import Buffer
+from .empty import EmptyBuffer

src/controller/buffers/base/account.py

@@ -0,0 +1,56 @@
+# -*- coding: utf-8 -*-
+""" Common logic to all buffers in TWBlue."""
+import logging
+import config
+import widgetUtils
+from pubsub import pub
+from wxUI import buffers
+from . import base
+
+log = logging.getLogger("controller.buffers.base.account")
+
+class AccountBuffer(base.Buffer):
+    def __init__(self, parent, name, account, account_id):
+        super(AccountBuffer, self).__init__(parent, None, name)
+        log.debug("Initializing buffer %s, account %s" % (name, account,))
+        self.buffer = buffers.accountPanel(parent, name)
+        self.type = self.buffer.type
+        self.compose_function = None
+        self.session = None
+        self.needs_init = False
+        self.account = account
+        self.buffer.account = account
+        self.name = name
+        self.account_id = account_id
+
+    def setup_account(self):
+        widgetUtils.connect_event(self.buffer, widgetUtils.CHECKBOX, self.autostart, menuitem=self.buffer.autostart_account)
+        if self.account_id in config.app["sessions"]["ignored_sessions"]:
+            self.buffer.change_autostart(False)
+        else:
+            self.buffer.change_autostart(True)
+        if not hasattr(self, "logged"):
+            self.buffer.change_login(login=False)
+            widgetUtils.connect_event(self.buffer.login, widgetUtils.BUTTON_PRESSED, self.logout)
+        else:
+            self.buffer.change_login(login=True)
+            widgetUtils.connect_event(self.buffer.login, widgetUtils.BUTTON_PRESSED, self.login)
+
+    def login(self, *args, **kwargs):
+        del self.logged
+        self.setup_account()
+        pub.sendMessage("login", session_id=self.account_id)
+
+    def logout(self, *args, **kwargs):
+        self.logged = False
+        self.setup_account()
+        pub.sendMessage("logout", session_id=self.account_id)
+
+    def autostart(self, *args, **kwargs):
+        if self.account_id in config.app["sessions"]["ignored_sessions"]:
+            self.buffer.change_autostart(True)
+            config.app["sessions"]["ignored_sessions"].remove(self.account_id)
+        else:
+            self.buffer.change_autostart(False)
+            config.app["sessions"]["ignored_sessions"].append(self.account_id)
+        config.app.write()

src/controller/buffers/base/base.py

@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+""" Common logic to all buffers in TWBlue."""
+import logging
+import wx
+import output
+import sound
+import widgetUtils
+
+log = logging.getLogger("controller.buffers.base.base")
+
+class Buffer(object):
+    """ A basic buffer object. This should be the base class for all other derived buffers."""
+
+    def __init__(self, parent=None, function=None, session=None, *args, **kwargs):
+        """Inits the main controller for this buffer:
+          @ parent wx.Treebook object: Container where we will put this buffer.
+          @ function str or None: function to be called periodically and update items on this buffer.
+          @ session sessionmanager.session object or None: Session handler for settings, database and data access.
+        """
+        super(Buffer, self).__init__()
+        self.function = function
+        # Compose_function will be used to render an object on this buffer. Normally, signature is as follows:
+        # compose_function(item, db, relative_times, show_screen_names=False, session=None)
+        # Read more about compose functions in sessions/twitter/compose.py.
+        self.compose_function = None
+        self.args = args
+        self.kwargs = kwargs
+        # This will be used as a reference to the wx.Panel object wich stores the buffer GUI.
+        self.buffer = None
+        # This should countains the account associated to this buffer.
+        self.account = ""
+        # This controls whether the start_stream function should be called when starting the program.
+        self.needs_init = True
+        # if this is set to False, the buffer will be ignored on the invisible interface.
+        self.invisible = False
+        # Control variable, used to track time of execution for calls to start_stream.
+        self.execution_time = 0
+
+    def clear_list(self):
+        pass
+
+    def get_event(self, ev):
+        """ Catch key presses in the WX interface and generate the corresponding event names."""
+        if ev.GetKeyCode() == wx.WXK_RETURN and ev.ControlDown(): event = "audio"
+        elif ev.GetKeyCode() == wx.WXK_RETURN: event = "url"
+        elif ev.GetKeyCode() == wx.WXK_F5: event = "volume_down"
+        elif ev.GetKeyCode() == wx.WXK_F6: event = "volume_up"
+        elif ev.GetKeyCode() == wx.WXK_DELETE and ev.ShiftDown(): event = "clear_list"
+        elif ev.GetKeyCode() == wx.WXK_DELETE: event = "destroy_status"
+        # Raise a Special event when pressed Shift+F10 because Wx==4.1.x does not seems to trigger this by itself.
+        # See https://github.com/manuelcortez/TWBlue/issues/353
+        elif ev.GetKeyCode() == wx.WXK_F10 and ev.ShiftDown(): event = "show_menu"
+        else:
+            event = None
+            ev.Skip()
+        if event != None:
+            try:
+                ### ToDo: Remove after WX fixes issue #353 in the widgets.
+                if event == "show_menu":
+                    return self.show_menu(widgetUtils.MENU, pos=self.buffer.list.list.GetPosition())
+                getattr(self, event)()
+            except AttributeError:
+                pass
+
+    def volume_down(self):
+        """ Decreases volume by 5%"""
+        if self.session.settings["sound"]["volume"] > 0.0:
+            if self.session.settings["sound"]["volume"] <= 0.05:
+                self.session.settings["sound"]["volume"] = 0.0
+            else:
+                self.session.settings["sound"]["volume"] -=0.05
+        sound.URLPlayer.player.audio_set_volume(int(self.session.settings["sound"]["volume"]*100.0))
+        self.session.sound.play("volume_changed.ogg")
+        self.session.settings.write()
+
+    def volume_up(self):
+        """ Increases volume by 5%."""
+        if self.session.settings["sound"]["volume"] < 1.0:
+            if self.session.settings["sound"]["volume"] >= 0.95:
+                self.session.settings["sound"]["volume"] = 1.0
+            else:
+                self.session.settings["sound"]["volume"] +=0.05
+        sound.URLPlayer.player.audio_set_volume(int(self.session.settings["sound"]["volume"]*100))
+        self.session.sound.play("volume_changed.ogg")
+        self.session.settings.write()
+
+    def start_stream(self, mandatory=False, play_sound=True):
+        pass
+
+    def get_more_items(self):
+        output.speak(_(u"This action is not supported for this buffer"), True)
+
+    def put_items_on_list(self, items):
+        pass
+
+    def remove_buffer(self):
+        return False
+
+    def remove_item(self, item):
+        f = self.buffer.list.get_selected()
+        self.buffer.list.remove_item(item)
+        self.buffer.list.select_item(f)
+
+    def bind_events(self):
+        pass
+
+    def get_object(self):
+        return self.buffer
+
+    def get_message(self):
+        pass
+
+    def set_list_position(self, reversed=False):
+        if reversed == False:
+            self.buffer.list.select_item(-1)
+        else:
+            self.buffer.list.select_item(0)
+
+    def reply(self):
+        pass
+
+    def send_message(self):
+        pass
+
+    def share_item(self):
+        pass
+
+    def destroy_status(self):
+        pass
+
+    def post_status(self, *args, **kwargs):
+        pass
+
+    def save_positions(self):
+        try:
+            self.session.db[self.name+"_pos"]=self.buffer.list.get_selected()
+        except AttributeError:
+            pass