Skip to content
Tweet quickly from the desktop without any distractions.
Branch: master
Clone or download
Latest commit 2d38677 Feb 17, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Remove e2e tests from config Mar 4, 2018
.github Update Mar 22, 2018
.vscode remove some dependencies that aren't needed Jan 26, 2018
app update version Feb 12, 2019
internals extra action types and add action tests Feb 10, 2018
resources update Settings view to be it's own route Mar 1, 2018
test update tests Mar 23, 2018
.babelrc Added babel plugin, added Header test, fixed older tests Mar 5, 2018
.eslintignore remove some dependencies that aren't needed Jan 26, 2018
.eslintrc Added new ignores Feb 16, 2018
.gitattributes v0.13.0 (#1166) Jan 6, 2018
.gitignore ignore yarn.lock Feb 5, 2018
.stylelintrc Added initial stylelint support (#911) Apr 13, 2017 Update Feb 17, 2019 feat: add change log file Feb 8, 2018 updated templates and readme Feb 9, 2018 Update Feb 17, 2019
package-lock.json fix some platform things Feb 4, 2018
package.json update version Feb 12, 2019
webpack.config.base.js added null state to html when loading, redirected logout to login screen Jan 27, 2018
webpack.config.eslint.js Rename webpack configs (#881) Mar 31, 2017 Merge branch 'master' of… Feb 5, 2018 added gif entry point and label, fixed prod store Jan 28, 2018 added null state to html when loading, redirected logout to login screen Jan 27, 2018 added null state to html when loading, redirected logout to login screen Jan 27, 2018

Tweet Tray 🐦

CircleCI Github Downloads GitHub Release Project License

Table of Contents


OSX Day Windows Day

Tweet Tray is a small application which allows you to tweet from your desktop taskbar or menubar, without any further distractions. The core technology used consists of Electron, React + Redux and Styled Components. All transpiled from ES6 Javascript.


🍎 MacOS

🏨 Windows

🐧 Linux (AppImage)

🐧 Linux (DEB File)

See releases for more information.

Install with Homebrew

You can also install Tweet Tray with Homebrew Cask, brew cask install tweet-tray.


Some application settings can be passed via commandline arguments. For a full list, run the executable from the commandline with the --help argument.

  • --proxy You can configure Tweet Tray to use a HTTP proxy server, by setting the --proxy argument. This takes a string value of the proxy server address and port, in the form of --proxy address:port. This also supports SOCKS5 by using the socks5 protocol prefix, eg --proxy socks5://address:port.

Report Bugs

Please create a Github issue and provide as much information as possible regarding the bug, including images or error codes. To make things as uniform as possible please follow the guidelines set out in


  1. Fork the Tweet Tray repository on Github to your own account then clone it locally.

  2. To run Tweet Tray locally you will need to first install npm and yarn package managers.

  3. Setup the applications' dependencies by navigating to the tweet-tray directory and run yarn install.

  4. Before you can use all functions of Tweet Tray you'll need to create your own Twitter OAuth Application to test. You don't need to set a callback URL, as Tweet Tray uses a mannually input Authorization code. After that, take the Consumer Key and Secret and update your local config.js file found under app/utils.

  5. After everything has been installed simply call yarn dev to run the development build. To run the production build you can call yarn prestart followed by yarn start.

For all new features or bug fixes please create an issue in the main repository first (so we can track what goes into each release) then simply submit a pull request from your own fork into the original develop branch. To make sure the changes are easily reviewable please repect the format set out in


To create an installable build simply call yarn package, which will create an executable based on your current operating system. If you want to debug something in a packaged build you can call DEBUG_PROD=true yarn package.


This project is based off electron-react-boilerplate, all methodologies still apply, except for the removal of Flow and SASS. Issue and pull request templates based on formats by yoshuawyts.

You can’t perform that action at this time.