Welcome to the next generation of accessible twitter! Chicken nugget is an intuitive, high-quality and full-featured Twitter client. With Chicken Nugget you can easily browse, search and tweet from the client's streamlined user interface, or read your tweets from any other window with natural global commands. This document will describe the features and usage of the program.

An important note on keystrokes

When Microsoft released Windows 10, many of the default keystrokes which Chicken Nugget relied upon were taken over by operating system functions. To work around this, Chicken Nugget will alter its keymap automatically if it detects that it is running on Windows 10 or a later operating system. Any keystroke which previously used control+windows now defaults to alt+windows. The very few alt+windows keystrokes are now moved to control+alt+windows. This documentation references the default keystrokes, and for the most up-to-date listing of keystrokes you should consult the keystroke manager inside the application.

Signing in to your twitter account

When you open Chicken nugget for the first time, you will be presented with the accounts list. You can choose to sign in to an existing account, or create a new one. When you select the "Add existing twitter account" button, your default web browser will open to a page on where you can enter your username and password to authorize the application to use your account. Once this is done, the accounts window will close, and Chicken Nugget will retrieve your latest tweets.

You can return to the account list to add, switch or remove accounts at any time by selecting "Switch Account" from the application menu.

Two ways to Use chicken nugget

Chicken Nugget gives you two methods for working with twitter. The first way is to use the controls found in the program's main window. The second option is to use a set of convenient global hotkeys. These commands are available from anywhere on your system, meaning that you can read and send tweets without leaving the application you are working with. At any time, you can press ctrl+windows+w to show or hide the chicken nugget window. The main body of this document will describe the usage of the program window, while the global commands will be listed in an index at the end of the document.

The Main Window

Chicken Nugget is built around the concept of timelines. These timelines contain tweets, users, and other such items and display them, either on the screen or through the speech interface. Timelines are grouped together by their common purpose. These groups are easily accessible from the main window by using the navigation treeview. By default, the navigation treeview contains five groups: Timelines, Relationships, Popular, Sent, and Events. Other groups may appear and disappear depending on which timelines are spawned.


When you first open the window, you will be placed in the timelines group. It contains four timelines:


The Mentions timeline shows public mentions that other users have sent to you. A mention is any tweet which contains your screen name on Twitter, proceeded by an at sign (@).


The home timeline displays the tweets from all of the accounts that you follow.

Direct Messages

the Direct Messages timeline shows private messages you have received.


Finally, the likes timeline shows all tweets that you have liked.


The search tab allows you to search twitter for both tweets which contain a particular term, as well as other Twitter users to follow.

Search results contain tweets from anyone on twitter with a public account, not just those you follow. To create a search, enter a term in the search term field, and press enter or select the search button. A new timeline will open with your search results. You can repeat this process to add other searches to this tab. To remove an active search timeline, select "Dismiss timeline" from the timeline menu while focused on the search you wish to remove, or press the dismiss timeline keystroke, which defaults to control+windows+backspace.


The lists group contains timelines for all twitter lists that you have either created or subscribed to. By default, the lists group is not shown until you select the lists you want to see in the list manager and press the View List button. To have a list automatically shown when you start the program, once the list has been shown, select Persist Across Restarts in the timeline menu for that list. Lists are a great way to organize accounts into smaller, more manageable or topical timelines.


The relationships group contains three timelines. The Followers timeline shows all of the users that are currently following you, while the friends timeline contains everyone that you follow. The blocked timeline shows all users that you have chosen to block. We will talk more about blocking users later in this guide. In any of these lists, you can press enter on a user to see more details about them.


The popular group contains two timelines which spotlight your own tweets that other users on Twitter have shown an interest in. The retweeted timeline shows your tweets that have been retweeted by others, while the favorited timeline shows which of your tweets have been marked as a favorite by others.

User Timelines

The user timelines group allows you to view a list of a particular user's tweets. By default, this group is not visible. You can get a user's individual timeline to appear by pressing ctrl+u. This will display a list of users, including the sender of the selected tweet and all other users that are mentioned. You can select one of these users, or enter a different username to open their timeline. You can close an individual user timeline by selecting "dismiss timeline" from the timeline menu.


The sent group contains two timelines: The sent tweets list displays a list of your public tweets, and the sent direct messages list displays the direct messages that you have sent.


The events group contains an events timeline which displays various things that happen on Twitter which you may be interested in. It will show you when someone starts following you, when someone favorites your tweet, and several other useful events.

Sending tweets and direct messages


To send a new tweet, press ctrl+t, or select "tweet" from the compose menu. A dialog will open where you can enter your tweet, upload images, add audio clips and more. Tweets have a maximum length of 140 characters. The title bar of the new tweet dialog contains a counter which will show how much more you can type before reaching the limit. If you go over the limit, a sound will play each time you type. When you have finished typing your tweet, press enter or select the send button.

Direct Messages

To send a direct message to someone, press ctrl+d or select "Direct message" from the compose menu. The direct message dialog will open. The recipient combo box contains the user who sent the currently selected tweet, and any other users that are mentioned. Select a username from the list or enter a different one manually. While typing the text of your direct message, the character counter works just as described above.

Working with tweets

There are several actions which you can perform on the currently selected tweet:

Working with users

The user menu in chicken nugget Contains actions that you can take related to how you interact with another user on twitter. When you select any of these menu items, you will be asked to select a user for that action to be applied to. The list will contain the user that wrote the currently selected tweet, as well as any other user that was mentioned, quoted, or retweeted. You may select one of these or enter a different username. The actions available in the user menu are as follows:

Options for timelines

In the timeline menu, you will find the following options for specific timelines:


Chicken Nugget allows you to control what information you receive in timelines through a powerful template system. You can edit all templates from the "Edit templates" option in the Timeline menu. All template variables are preceded by a dollar sign ($). Below are listed all template variables and their meanings. Feel free to experiment with different settings, and remember that the "restore defaults" button works as advertised and will restore your templates to their default configuration.

Filtering Timelines

Chicken Nugget lets you easily and rapidly filter your timelines so that you only see the tweets you care about. For instance, if you don't want to see any 4Square checkin tweets, you can easily exclude them from your home timeline. You can invoke the filter dialog for a particular timeline by selecting the edit filters... option from the filter menu, or by pressing the global hotkey control+windows+shift+f. To add a new filter, tab to the add button in the filter dialog or press alt+a. You can also edit existing filters, and remove filters. Once you have clicked add, you will be presented with a dialog for defining your new filter. Select the field the filter should apply to. For instance, to filter on the text of tweets, select text in the field combo box. To return to our example of filtering out 4Square checkins, you should note that all 4Square checkins come from the 4Square client. The client is available in the source field, so select source in the field list. Tab to the text field and enter the term 4square. Tab to the exclude checkbox and check it. Press enter and the filter will be added to the current timeline's list of filters. This filter will persist for the life of the timeline, including across Chicken Nugget restarts, so it makes a very handy way to cut down on the clutter of your Twitter feed.

Audio Cues

Chicken Nugget has a variety of sounds which it will play to notify you when things happen. To quickly familiarize yourself with these sounds, select Learn Sounds... from the Application menu.

Tweeting more than 140 characters

Chicken Nugget allows for the use of Third-party services to expand your tweets. You can use the check box in the Compose Tweet dialog to post a tweet of more than 140 characters. When you come across these sorts of tweets that others have posted, you will hear an audio cue, and then you can interact with the tweet by pressing control windows enter to bring up a dialog containing the expanded text of the tweet. You can also access this dialog from the tweet menu in the application's menu bar.

Translating Tweets posted in other languages

If someone tweets something in a language you don't understand, , you can press control+windows+alt+t on the tweet and it will be translated into your system's default language and the text placed in a dialog. You can also access this functionality from the tweet menu.

Images and OCR

Many tweets include images. You can identify these tweets easily because an audio cue is played when you traverse over them. These images sometimes contain, or are mostly made up of text, for instance a lead to a news story. To use optical character recognition (OCR) to attempt to recognise and display any text in a tweet, use the OCR Image command, control+windows+O, on the tweet or select OCR from the Tweet dialog.

Per-Account Soundpacks

A soundpack tells Chicken Nugget what sounds to play when a particular event, like a new tweet coming in happens. It is useful to be able to tell just by an audio cue which account something happened on, and Nugget gives you this ability. Bring up the Application menu in the main window, select Set Account Soundpack, and pick one of the provided soundpacks. Anything that happens in the selected account will be played through this soundpack.

The Options Dialog

Chicken Nugget has customizable options, accessed from the Application menu of the main window.

Global Hotkeys

Most actions which you can perform with Chicken Nugget can be bound to global hotkeys. Several of these have already been mentioned in this document. To obtain a list of all possible commands, along with their associated keystrokes and a short description of each command, open the Hotkey Editor from the Application menu.

Editing Keystrokes

Chicken Nugget lets you redefine which global keystrokes invoke which commands. You can bring up the keystroke editor by selecting it from the Application menu, or by pressing control+K while focused in the main window. Select a command from the list and click the edit button to change the keystroke used for it. The keymap will update as soon as you click OK to close the Keymap editor.

Portable Mode

Portable mode allows you to run Chicken Nugget from any folder on your computer: Dropbox, USB storage devices, and more. If you have purchased Chicken Nugget, you will be required to perform a one-time product activation on every new computer you use the application on. Your settings and other information will be preserved between portable runs of the application and saved in the folder user_data inside the application's folder.

Automatic Update

Chicken Nugget has an automatic update feature. It will check for a newer version every time it is started, as well as every 2 hours. To disable the automatic update feature, add --disable-autoupdate to the application command line. Note: this flag does not work with beta versions of Chicken Nugget.

Change Log

Version 4.2

version 4.1

Version 4.0

Version 3.2

Version 3.1

Version 3.0

Version 2.4

Version 2.3

Version 2.2

Version 2.1

Version 2.02

Version 2.01

Version 2.0

Version 1.42

Version 1.41

Version 1.4

Version 1.31

Version 1.3

Version 1.22

Version 1.21

Version 1.2

Version 1.11

Version 1.1

Version 1.01

Version 1.0

Version 0.971

Version 0.97

Version 0.963

Version 0.962

Version 0.961

Version 0.96

Version 0.951

Version 0.95

Version 0.94

Version 0.932

Version 0.931

Version 0.93

Version 0.92

Version 0.91

Version 0.9

Version 0.8631

Version 0.862

Version 0.861

Version 0.85

Version 0.83

Version 0.82

Version 0.81

Version 0.8

Version 0.74

Version 0.73

Version 0.72

Version 0.71

Version 0.7

Version 0.6

Version 0.53

Version 0.52

Version 0.512

Version 0.51

Version 0.5

Version 0.4

Version 0.3