<metaname="description"content="NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument."/>
<metaproperty="og:description"content="NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument."/>
{"@context":"https://schema.org","@type":"WebPage","description":"NewsBlur is a personal news reader that brings people together to talk about the world. A new sound of an old instrument.","headline":"The NewsBlur Blog","publisher":{"@type":"Organization","logo":{"@type":"ImageObject","url":"https://blog.newsblur.com/assets/newsblur_logo_512.png"}},"url":"https://blog.newsblur.com/page11/"}</script>
<p>NewsBlur was released exactly one year ago. You can read the initial reaction on Hacker News: <ahref="http://news.ycombinator.com/item?id=1834305.">http://news.ycombinator.com/item?id=1834305.</a> Since then, so much has changed and all for the better. Usage is up—way, way up. Premium users are helping the site run. Load times are approaching the goal of less than 100 ms (0.10 sec) per page. In short, things couldn’t be better.</p>
<p>Recently, my main competitor, Google Reader, announced plans to decommission the social features of the site and integrate them into Google+. While Google is busy refocusing on what’s important to them, many users feel left behind. My goal with NewsBlur is to make a better, complete experience for reading sites. This includes social features that make reading a social experience.</p>
<p>Social is a major planned feature. It’s highly prioritized right after I build two other big ticket items: mobile and search. The mobile iPhone app is wrapping up and is already at version 1.1 on the App Store, although I have not publicly launched it because it still needs a few more features (specifically, training and the river of news) to be considered feature-complete.</p>
<p>Once that’s out the door, I have to build search to be able to support social. Search won’t be impossible, since the UI design decisions are fairly straight-foward, and the backend is a no-brainer in terms of design. But it’ll take some time to get right, make fast, and get integrated into the massive database that is quickly accumulating.</p>
<p>After that, I have so many social ideas swimming in my head that I’m ready to drown. I’ve had these social features planned since day one. But I never built them because I needed to make a proof-of-concept first, to be sure that social features would be even feasible.</p>
<p>Also, you can’t discount the immense network effort that building social features would bring. I’m a solo indie developer working on this part-time. Having social features would crush my servers if used as much as I think they would. But know that I am planning some wonderful features to be released as soon as the pieces are in place. Look for the first inkling in the new year.</p>
<p>Let me know on Twitter what your ideas of a good social experience are: <ahref="http://twitter.com/samuelclay">@samuelclay</a>.</p>
<p>The iPhone app is now only a few days away from launching. But it took 3 weeks of sitting around in the App Store approval queue before getting here. During that time, I started working on the new customizations that folks have been asking for.</p>
<p>The first of these customizations is the story title pane. Most other readers allow you to position it wherever you like, and NewsBlur is now joining them in giving you that freedom.</p>
<p>You can change the positioning under Manage > Preferences.</p>
<p>I hope you like these new positions. There are a few other niceties in this release, namely that resizing window panes is now a live operation, showing you the content stretching in realtime.</p>
<p>There’s a lot more customizations coming out soon. Follow me on GitHub to watch them happen: <ahref="http://github.com/samuelclay">http://github.com/samuelclay</a>.</p>
<p>This Summer is shaping up to be the season for mobile apps. Blar, a new Android client for NewsBlur, has just been released. It’s available on the Android Market here: <ahref="https://market.android.com/details?id=bitwrit.Blar">https://market.android.com/details?id=bitwrit.Blar</a>. It is created by Harris Munir, who you can contact <ahref="http://harrism.com/">through his site</a>.</p>
<p>The source code to Blar is also released under <ahref="https://bitbucket.org/harris/blar/src/f9f8458a73c6/license.txt">a fair license</a> on Bitbucket: <ahref="https://bitbucket.org/harris/blar/">https://bitbucket.org/harris/blar/</a>.</p>
<p>In other news, the official NewsBlur iPhone app is nearly finished and is ready to be beta tested. If you are a premium user, <ahref="mailto:samuel@ofbrooklyn.com">email me your UUID and username</a> and I will send you your own free copy of the NewsBlur iPhone app. Just know that it is under heavy development and might change for the better in the near-term future.</p>
<p>Blar was created using the just released <ahref="http://www.newbslur.com/api">NewsBlur API</a>. If you create your own mobile app, bookmarklet, browser extension, or even desktop client, I’ll feature it either on the dashboard of every user or the Goodies section. I’m also happy to assist you in making the app, and even making new API endpoints for you if you wish. Just let me know and keep the NewsBlur apps rolling.</p>
<p><em>Please vote for this blog post on Hacker News: <ahref="http://news.ycombinator.com/item?id=2485377">http://news.ycombinator.com/item?id=2485377</a>.</em></p>
<p>It’s a big news day here at NewsBlur HQ. For those of you who don’t know, NewsBlur HQ is a comfy seat on the A train, part of the NYC subway system, since that’s where most of the code gets written anyhow.</p>
<p>I’m happy to announce <ahref="http://www.newsblur.com/api">NewsBlur’s brand-spanking-new API</a>. It’s free, it comes with tons of juicy data, and it can be used to create your own feed reader. Let’s look at what this all means.</p>
<p><ahref="http://www.newsblur.com">NewsBlur</a> is a visual feed reader with intelligence. This API gives you access to all the moving parts that make up the flagship newsblur.com site. This includes the original site, stories, intelligence classifiers, statistics, and a really neat River of News view that aggregates multiple feeds into a single view.</p>
<h2id="juicy-data-from-the-api">Juicy Data from the API</h2>
<p>Let’s take a quick look at a visualization of the data you can get out of the API. This is a screenshot from the Statistics dialog from a single feed:</p>
<p>Without going too deep into explaining various parts of the API, you can dive right into it by viewing the various API endpoints at <ahref="http://www.newsblur.com/api">http://www.newsblur.com/api</a>. The API is meant to be used with an authenticated account, which can be created directly from the API. I spent a lot of time polishing the look and readability of the API, so I hope you like it, since if you’re going to be developing on top of it, you will probably spend a looong time working with the 30 endpoints.</p>
<p>I’d like to briefly note that I work on NewsBlur in my free time, and it’s entirely open-source on GitHub: <ahref="http://github.com/samuelclay">http://github.com/samuelclay</a>. This API is the result of 22 months of work and thought. But it’s not corporate, not funded, and certainly not battle-tested. Go easy on it for the time being. And <ahref="http://twitter.com/samuelclay">offer feedback on Twitter</a>.</p>
<h2id="is-making-a-newsblur-client-cannibalism">Is making a NewsBlur client cannibalism?</h2>
<p>Woah! How does that even work? There’s no endpoint for <em>cannibalism</em>. (OK, there is, it’s <codeclass="language-plaintext highlighter-rouge">/reader/delete_feed</code>.) But what does this API mean for you?</p>
<p>Twitter has a web client, but the real iceberg is the ecosystem built on their API. Google Reader has a website, but more than a handful of enormous venture-engorged companies make their living by using the Reader API.</p>
<p>If you choose to use the NewsBlur API, you are building complements to the website. You can mix-and-mash data as you please. But more importantly, you can use NewsBlur data in ways that are not even possible on the website today.</p>
<p>Want to mix up a social layer with the subscriptions in your NewsBlur account? Just use <codeclass="language-plaintext highlighter-rouge">/reader/feeds</code>, <codeclass="language-plaintext highlighter-rouge">/reader/feed/:id</code>, and <codeclass="language-plaintext highlighter-rouge">/rss_feeds/statistics</code>. Got an Android device and want to make a mobile client that you can <em>charge money</em> for and make a profit? The NewsBlur API supports that.</p>
<p>What you can’t do is wrap advertisements around NewsBlur data. Why? Because NewsBlur preserves the original site, so there are already ads on the page if the publisher chooses to have them. Additionally, ads degrade the NewsBlur experience. NewsBlur is not some fly-by-night air-ride-equipped service out to make a buck. NewsBlur is built to make life better, a small net-enabled reading experience at a time. Profit is great, but not at the cost of ads.</p>
<h2id="if-you-build-it-they-will-come-and-theres-no-hard-scaling-part">If you build it, they will come, and there’s no hard scaling part</h2>
<p>You’re building on an API, not a service end-to-end. If you want to handle the scaling part, use the raw NewsBlur code on GitHub: <ahref="http://github.com/samuelclay">http://github.com/samuelclay</a>. NewsBlur.com will take care of the scaling and infrastructure, and you can take care of building a new layer that might make you famous/well-off/existentially-happy.</p>
<p>The API is ready for you at <ahref="http://www.newsblur.com/api">http://www.newsblur.com/api</a>.</p>
<p>Questions? Feedback? Want to stay up to date when I drive cross country and take photos of the beautiful countryside between New York and California? Follow <ahref="http://twitter.com/samuelclay">@samuelclay on Twitter</a>.</p>
<ul>
<li>Samuel Clay, innocent Founder of NewsBlur</li>
<p>Hi readers, I want to take a moment to share what I’m working on for the month of April:</p>
<ul>
<li>The API: This is the biggest and baddest update since the River of News and premium accounts. The API includes some lightweight rewrites of how NewsBlur communicates to the back-end server. It’s going smoothly, and you can watch the progress on the less-than-aptly named branch <ahref="https://github.com/samuelclay/NewsBlur/commits/dashboard_tweaks">dashboard_tweaks on GitHub</a>.</li>
</ul>
<p>The goal for the API is to have users build Android and iPhone apps on top of NewsBlur. Heck, even web apps which use NewsBlur data sound just fine. Whatever it is, I want to support it.</p>
<ul>
<li>Graphs on the Dashboard: I want to add some transparency to how the NewsBlur service is doing, both in terms of user growth and server status. I am adding a few graphs and numbers to the dashboard to show off how many premium and standard users have logged in during the past day, as well as how many feeds have been loaded, the response time for those feeds, and if there is a backlog for feed fetching.</li>
<li>Bug fixes: If you watch how often I’m committing to NewsBlur on GitHub, you may notice that a handful of bugs are fixed every single day. If you see a bug and it hasn’t been fixed, let me know on Twitter at <ahref="http://twitter.com/samuelclay">@samuelclay</a>, or email me at <ahref="mailto:samuel@ofbrooklyn.com">samuel@ofbrooklyn.com</a>.</li>
<li>Press page: Along with the API there will be a press page to showcase the nearly 40 articles and reviews written about NewsBlur. This page will also have a press kit, since one of the easiest ways to get reviewed is to have a number of materials at the ready.</li>
<li>Publisher information: If you’re a publisher and you want to make sure the NewsBlur experience is tip-top for your readers, this new page will highlight how to make the Original view work best.</li>
</ul>
<p>The work is progressing and it won’t be long now until everything above is ready for you to use and enjoy. There are a few other features that may make it out if I find myself working through everything else quickly enough.</p>
<p>I recently launched a feature to show an aggregation of the intelligence classifiers that users are using on their sites. Soon, this data may come back to implicitly recommend stories for you. But in order for there to be enough data to make recommendations useful, more users needs to classify stories they like and dislike.</p>
<p>The chart below shows the growth of different intelligence classifiers. The trend is up for tags, authors, feeds, and titles. That’s very good news.</p>
<p>If you’re not using intelligence classifiers, you’re only getting half the value out of NewsBlur.</p>
<p>Intelligence classifiers are the phrases, tags, and authors that you like and dislike. Training your sites by choosing classifiers for each feed will automatically highlight the stories you want to read and hide the stories you don’t want to see.</p>
<h2id="whats-happening-under-the-hood">What’s happening under the hood</h2>
<p>To get a better picture of how stories are being classified into the red, yellow, and green states, we need to take a look at how NewsBlur is using your intelligence classifiers and applying them to stories.</p>
<p>When you select a tag, author, or phrase, NewsBlur looks for an exact match in all other stories in the same feed. It’s a very simple match, and nothing mysterious is happening without you being explicit about what you want to see.</p>
<p>Green always wins. If you have 2 green classifiers and 3 red classifiers on a single story, the story will show up green, since it’s clear there is at least *something* you like about the story.</p>
<p>However, classifying the publisher (i.e. the feed itself) works slightly differently. If you specify that you like or dislike the feed, all stories are automatically classified according to this preference, unless there is a tag, author, or title phrase that is classified, in which case it wins over the feed’s classification.</p>
<p>This offers a neat trick to hide most stories from a feed, even in the yellow intelligence state, except for the few stories that you want to watch. Simply train the feed to dislike the feed itself, but give a thumbs up to the tags/authors/phrases in the stories you want to read. This will result in all stories being either red or green, which keeps the site out of your yellow intelligence setting.</p>
<h2id="whats-in-store-for-the-future">What’s in store for the future</h2>
<p>Right now the intelligence classifiers are pretty naive. But the impetus for building NewsBlur was to passively train your feeds, just based on your implicit preferences. There’s a lot of work to be done to make this happen, and you can follow NewsBlur’s progress over on GitHub at <ahref="http://github.com/samuelclay">http://github.com/samuelclay</a>.</p>
<p>We’ve come a long way, readers. What started as a fun project to scratch an itch has become a fun project that pays for its ever-increasing self. This week I’m going to show how motivated I am about turning NewsBlur into a serious blog reader. And it starts with a collection of a circles:</p>
<p>What may take you, somebody who has done more than only crop images in an image editor, only a few minutes took me on the order of 1-2 hours a day over 5 days. It’s always like this. Slow as sin until you start to pick up how the editor wants you to work. Then it’s gravy. I could, in fact, completely redo the logo in 10 minutes on a blank canvas. That’s how it goes.</p>
<p>The biggest difference is not the new logo, which sits comfortably underneath your sites when reading, but the new favicon.</p>
<p>This little guy sits there, staring at you the whole time, and reminding you where you are. He had to be created separately, but once you know what the hell a mask is, resizing and showing exaggerated pixels is child’s play.</p>
<divclass="footer-col footer-col-1"><ulclass="social-media-list"><li><ahref="https://github.com/samuelclay"><svgclass="svg-icon"><usexlink:href="/assets/minima-social-icons.svg#github"></use></svg><spanclass="username">samuelclay</span></a></li><li><ahref="https://www.twitter.com/newsblur"><svgclass="svg-icon"><usexlink:href="/assets/minima-social-icons.svg#twitter"></use></svg><spanclass="username">newsblur</span></a></li><li><ahref="mailto:blog@newsblur.com?subject=Hello from the NewsBlur blog"><svgclass="svg-icon"><usexlink:href="/assets/minima-social-icons.svg#email"></use></svg><spanclass="username">blog@newsblur.com</span></a></li></ul>
</div>
<divclass="footer-col footer-col-3">
<p>NewsBlur is a personal news reader that brings people together to talk about the world.<br/>
