Piyo

Piyo is an open source Twitter client for Mac OS X.

It displays a modified version of the Twitter website using Google Chrome.

Screenshot

Installation

• Download the zip
• Unzip it, if required
• Run the app
• Enjoy

Requirements

Google Chrome should be installed to /Applications for Piyo to work correctly.

Background

Piyo is heavily customised to provide a feature-rich experience. It uses custom styles, scripts and extensions to do the dirty work.

Everything has been configured to a high degree over a long period of time, meaning it should not require you to do anything other than login to the Twitter website to get the most out of it.

Features

You can see how Piyo compares with other Mac OS X Twitter clients in this spreadsheet: http://bit.ly/mactwitter

The following features are supported:

User Styles

• Standard website displayed in large window
• Minimal interface in small window

Configuration: Stylish extension.

Remote User Scripts

• Expanded keyboard control
• External links open in new window
• No promoted tweets
• Quote retweet RT support
• Send on ⌘Return option
• Timeline Link Title Replace with Expanded
• No line breaks in tweets
• Mac-like shortcut keys
• Filter tweets containing keyword (optional)
• Replace Connect with Mentions (optional)
• Custom window title (optional)
• Check for update (work in progress)

Configuration: Tampermonkey extension.

Browser Extensions with remote configuration

• No ads (AdBlock)
• Streaming (Refresh for Twitter)
• Translate tweet (Instant Translate)
• Reports itself as unique client (ModHeader)

Configuration: browser settings.

Browser Extensions with local configuration

• Expand short links (PageExpand)
• Inline images (PageExpand)
• Highlight keywords (Word Highlight)

Configuration: browser settings.

Browser itself

• Font size control
• Window size control
• Translate user (optional)

Configuration: browser settings.

Shortcut keys

Cursor keys: navigate timeline
Return: expand tweet
Escape: close all expanded tweets
Cmd + Return: send tweet
Cmd + Escape: clear compose tweet box
Cmd + 1: home
Cmd + 2: connect
Cmd + 3: discover
Cmd + 4: profile
Cmd + 5: messages
Cmd + 6: lists
Cmd + i: add image...
Cmd + u: go to user...

Get Involved

Pull requests are accepted, and all feature suggestions will be considered and implemented when possible.

To Do

See GitHub Issues

Licence

This app is available under the MIT license. See the LICENSE file for details or visit http://opensource.org/licenses/MIT