User Guide

Keyword Block

Block screen shot

Hibari allows you to filter out tweets containing topics you don't want to hear about. For example, if you want to avoid mentions of a certain TV show for fear of spoilers, just create a keyword block setting with the name of that show.

If you put multiple words into one setting, Hibari will only block tweets that match all of those words.

Hibari's matching is case-insensitive, so a setting to block test will also block TEST.

Blocking automated tweets: Keyword blocking works great for hiding automated tweets from "tweet blast" promotions and check-in services like Foursquare or Gowalla. Simply add a filter containing the bit of text common to all those tweets (in Foursquare's case, that would be

Blocking retweets: Some people would rather not see any retweets. In Hibari, you can block both native (new-style) and old-style retweets by adding a filter that simply says RT.

By default, Hibari doesn't filter out mentions, DMs, and search results. If you'd like to create a setting that will filter out mentions, include your @username in the setting. E.g. if your username is @justin, and you want to block mentions that include the word “bieber,” create a keyword block setting for @justin bieber.

Mute screen shot


The mute feature was created because there needed to be a way to temporarily hide someone's messages without unfollowing them. (As some people interpret unfollowing as un-friending, unfollowing can cause social awkwardness or hurt feelings.) With mute ability, you can now liberally follow people knowing you can always mute them if their tweets go overboard.

Hibari will not block replies or DMs from the person you're muting so you can still respond to conversations with that person and not appear to be totally ignoring them.

Coming soon: Mute duration. In an upcoming version of Hibari, you will be able to hide someone's tweets for a specific number of days, e.g. for the 3 days they're live-tweeting a conference you don't care about.

Saved Searches

Search screen shot

In Hibari, you don't have to monitor a separate timeline to see your most important search results. Check the "Display results in home timeline" checkbox next to any search term and all matching results will begin appearing in your home timeline.

We recommend using Twitter's search operators to increase the usefulness of your searches. For example, you can use the minus symbol to exclude a term from your search.

See all replies to someone: Normally, you only see conversations between users you follow. If you'd like to see every conversation involving a certain Twitter user, add a search setting that contains @user OR from:user (substituting your friend's username for user).

Monitor only certain types of tweets from a user: If you only want to see tweets from @nytimes if they're about NYC, you could create a search for from:nytimes NYC.

Note: Currently, we do not sync your Hibari searches with your saved searches on

Keyboard Shortcuts

Cheat sheet courtesy of

To save to your dashboard, select File > Open in Dashboard… (in Safari) and click on the cheat sheet.

Advanced & Hidden Features

To use hidden features, open up, which can be found in /Applications/Utilities/. Paste the command you want to use into the app and hit Return. Then, restart Hibari. If you need help, contact us via email or Twitter.

  • Instapaper support. Right-clicking on links will offer an “Instapaper” menu item if you've entered your Instapaper username and password via the following defaults commands:

    defaults write com.violasong.Hibari instapaperUsername '[email protected]'
    defaults write com.violasong.Hibari instapaperPassword 'fruitcompany'

    If you don’t have password, put in a blank one like this:

    defaults write com.violasong.Hibari instapaperPassword ''
  • Add "Retweet With Comment" to the contextual menu with the following command:

    defaults write com.violasong.Hibari retweetWithComment -bool YES
  • Customize Hibari’s timeline display with a user stylesheet stored in ~/Application Support/Hibari/custom.css. See for the selector structure. theme — CSS by @faypain

    Solarized Dark theme — CSS by @jj1bdx

  • Enable WebKit’s Web Inspector contextual menu item to understand Hibari’s element structure. Issue the following Terminal commands and restart Hibari to enable it:

    defaults write com.violasong.Hibari EnableWebInspector -bool YES
    defaults write com.violasong.Hibari WebKitDeveloperExtras -bool YES
  • Increase the maximum number of tweets in the timeline with the following command. Choose any number between 200 (the default) and 800. Higher numbers may affect performance.

    defaults write com.violasong.Hibari timelineDisplayCount -int 400
  • Add HJKL (vim-style) navigation with the following command:

    defaults write com.violasong.Hibari hjklNavigation -bool YES
  • Disable mentions in the main timeline from users you don’t follow with this defaults command:

    defaults write com.violasong.Hibari onlyDisplayHomeTimelineMentionsFromFriends -bool YES
  • Use low-resolution, faster-loading avatar images (for non-retina displays)

    defaults write com.violasong.Hibari nonretinaAvatars -bool YES
  • JSTalk support. You can script Hibari to access the currently selected tweet (-selectedTweet) and post a tweet (-tweet:). You can also use -compose: to update the compose field. To access the currently selected tweet, run the following:

    [[JSTalk application:'Hibari'] selectedTweet];

    Here’s the result:

        name = "Hacker News 20";
        screenName = newsyc20;
        tweetHTML = "Placebo buttons: 'door-close'
            buttons, others, don't do anything <a 
  </a> (<a href=\"http://bit
            <a class=\"hashtag\" href='https://twi
        tweetID = 1745811822084096;
        tweetText = "Placebo buttons: 'door-close'
            buttons, others, don't do anything htt
            p:// (
            z) #active";

    It’s just as easy to post a tweet:

    [[JSTalk application:'Hibari'] tweet:'hello world'];

    Here's how you can update the compose field: (thanks @o_lll)

    var hibari = [JSTalk application:'Hibari'];
    var currentTweet = [hibari selectedTweet];
    [hibari compose:'RT: @' + currentTweet.screenName + ': ' + currentTweet.tweetText];

    You can use JSTalk with an app like MarsEdit to easily blog about a tweet.

    Use FastScripts to launch your JSTalk script via a keyboard shortcut.



Give Hibari a try for free!

Download Hibari today for a free 14-day trial.

Version 1.5.9 • For Mac OS X 10.6+

Buy Now

Love what you see?

Buy Hibari now for just $10

Thanks for supporting indie software! Your purchase allows us to continue improving the app.