Radio3 Cross-platform linkblogging to Facebook, Twitter and a feature-full RSS feed. Wed, 01 Jul 2015 21:47:35 GMT Wed, 01 Jul 2015 21:47:35 GMT en-us Fargo v1.71 davewiner dave.winer.12 rssCloud support in Radio3 <p>The RSS feeds that <a href="">Radio3</a> generates, starting in v0.75, have &lt;cloud> elements. This means that people who subscribe to your feed in compatible aggregators will be notified immediately when you post a new item, and can show the news to readers immediately.</p> <p>This functionality is called <a href="">rssCloud</a>, it has been part of RSS since <a href="">version 0.92</a>.</p> <p>Here's <a href="">my linkblog feed</a> with rssCloud support, as an example.</p> <p><a href="">River4</a> supports rssCloud, as well as <a href="">WordPress</a>.</p> <p>Andrew Shell has released an <a href="">rssCloud server</a> for Node.js. We use his server for Radio3 feeds. </p> Fri, 05 Jun 2015 21:55:59 GMT Pushing links to Slack with Radio3 <p>New in <a href="">Radio3</a> v0.74, you can now push links to a Slack channel in addition to Facebook, Twitter and RSS.</p> <h4>Getting your WebHook address</h4> <p>The only tricky part of the setup is to get a magic URL from Slack that enables Radio3 to send messages to your channel.</p> <p>If you click on <a href="">this link</a>, it will redirect to your Incoming Web Hooks page. </p> <ol> <li><p>Choose a channel from the popup menu.</p></li> <li><p>Click the big green button, which takes you to a page with a long URL on it.</p></li> <li><p>Copy <a href="">the URL</a> to the clipboard.</p></li> </ol> <h4>In Radio3</h4> <ol> <li><p>Choose Settings from the menu at the right edge of the menu bar.</p></li> <li><p>Click on the Slack panel. You should see a bunch of settings <a href="">like this</a>. </p></li> <li><p>Paste your WebHook address in the first field.</p></li> <li><p>Click on the first panel in the Settings dialog, and check the box for Slack. </p></li> <li><p>Click OK.</p></li> </ol> <p>Now your Radio3 posts will go to Slack.</p> <h4>Customizing</h4> <p>We've set up defaults so your links will look like this when they arrive in Slack.</p> <p><img src="" width="400" height="57" border="0" style="border: 1px solid silver;" alt="A picture named radio3slackpost.png"></p> <p>If you erase the default values in the Settings dialog, you'll get the Slack default values. Or you can supply your own icon, change the name from to whatever you like, or use an Emoji to define your icon. </p> Mon, 25 May 2015 15:44:28 GMT Display a Radio3 linkblog in JavaScript <p>I display my linkblog on Scripting News, in the <a href="">Links tab</a>. </p> <p>To do this, I wrote a bit of JavaScript code. It's really very simple, and since this question comes up from time to time, I thought it would be good to share the code. </p> <p>Here's a <a href="">gist</a> on GitHub with the code. You can see this <a href="">running here</a>. </p> <p>You can use this as example code for your own projects.</p> Thu, 06 Nov 2014 14:55:26 GMT Radio3 v0.65 <p>The main feature in this release is the new blog post editor.</p> <h4>How to create a new post</h4> <ol> <li><p>Choose <i>Clear all fields</i> from the Feed menu.</p></li> <li><p>Choose <i>Blog post</i> from the popup menu above the text box.</p></li> <li><p>Enter the title of the post in the dialog that appears.</p></li> <li><p>Enter the text of your post in the edit box. You can use Markdown here.</p></li> <li><p>When you're ready to publish, click the Submit button.</p></li> </ol> <h4>Video demo</h4> <p>Here's a <a href=";">video</a> that demos the new feature, showing how to create a new post.</p> <h4>Example</h4> <p>This is what a <a href="">blog post</a> looks like.</p> <h4>How to edit a post</h4> <ol> <li><p>Click the edit icon in the same line as the post in the history table. </p></li> <li><p>When you're ready to publish your changes, click the Update button.</p></li> </ol> <h4>Other changes</h4> <ol> <li><p>Radio3 no longer puts up a modal dialog for errors in tweets. Instead it puts up a status message above the text entry box. The message stays there for 10 seconds, and is then removed. </p></li> <li><p>Improved the layout of the history table. </p></li> <li><p>Each of the icons in the history table shows a tool tip as you roll the mouse over them.</p></li> </ol> Thu, 16 Oct 2014 14:02:00 GMT Demo of new Radio3 editor <iframe width="960" height="720" src="//" frameborder="0" allowfullscreen></iframe> Wed, 15 Oct 2014 15:30:03 GMT What to do if you lose your posts <h4>Apology</h4> <p>First, I am sorry users have to even deal with this issue. It's not good and I want to fix the problem asap. But first let's talk about how to get your posts back. </p> <p>I'm using a new technique for storing user data, and it's a good one, but I'm still learning how it works, and fixing mistakes. </p> <h4>What to do</h4> <ol> <li><p>Choose <i>Restore from Backup</i> from the Feed menu. </p></li> <li><p>A confirmation dialog appear telling how many posts it was able to recover. If the number sounds right, click OK, and your posts will reappear in the History table.</p></li> <li><p>Please post a comment here, saying it happened. I want to know. </p></li> </ol> <h4>25 is the max</h4> <p>If you have more than 25 posts, and it reports it was able to restore 25, don't worry, that's all you need to restore, because it's using those posts to build your feed. We are maintaining an archive that goes back before the feed start point.</p> <h4>History</h4> <p>Early in the life of <a href="">Radio3</a> if there was an error getting your "prefs" from the server, you'd start over with a fresh setup. The next time you made a change, which usually was right away, the new empty data would overwrite the data on the server, and poof all your posts would be gone. This was terrible. It happened to me a couple of times, and the feeling was awful. I resolved to get to the bottom of it, and I think I have, and now I believe Radio3 works as it's supposed to.</p> <p>And even if it were to happen again, there's a pretty good chance we can get them back, because we're backing up the data independent of the "prefs" file. Eventually I want to switch to the backup method because even though it's a little slower, it's more reliable. </p> Tue, 23 Sep 2014 14:35:06 GMT Radio3 v0.57 is more robust <p>There are no user interface changes in this version of <a href="">Radio3</a>.</p> <p>I'm beginning a transition to a new way of storing posts, separate from prefs.</p> <p>Each post now is stored in a separate object on the server. The object is updated when you edit the post. So it should be possible to reconstruct the history table if there's a glitch. </p> <p>Eventually I want to transition to this method of storing posts. But for right now it's just a backup. </p> Tue, 16 Sep 2014 14:45:46 GMT Radio3 v0.56 has a deeper API <p>There's a new kind of "ping" implemented in this version of <a href="">Radio3</a>.</p> <p>Instead of sending the address of the user's RSS feed to the receiver, we send the full contents of the post, encoded in JSON.</p> <p>This makes a richer kind of connection possible, we expect.</p> <h4>Important caveat</h4> <p>Consider this an experimental feature. It's not frozen, it can change. Breakage could very easily happen. And it's conceivable the feature could be withdrawn. </p> <h4>Who this is for</h4> <p>Right now this is just for developers who can operate server applications.</p> <h4>When the messages are sent</h4> <p>When the user saves a new post, or edits an existing post, we send the update message.</p> <h4>How to set up</h4> <ol> <li><p>Choose <i>Settings</i> in the system menu (at the right edge of the menu bar).</p></li> <li><p>Go to the <i>Advanced</i> panel.</p></li> <li><p>Enter the URL of your receiver app in the second spot.</p></li> </ol> <p>Here's a <a href="">screen shot</a>.</p> <p>I've put up a simple handler at the address in the screen shot. It echoes the JSON struct it receives. No guarantees this will remain up for any period of time. <i class="fa fa-smile-o"></i> </p> <p>If you want to watch it operate, open the debugging console in the browser. Radio3 shows you the struct it's sending before the send, and the struct it received back. At this time it does nothing with the returned value, but maybe we should use it. <i class="fa fa-smile-o"></i> </p> <p>Also: <a href="">Getting started with Radio3</a>.</p> <h4>Example</h4> <p>Here's an <a href="">example</a> of the JSON that's sent when a post is updated.</p> <h4>How to tell an update from a new post</h4> <p>A new post will have a <i>ctSends</i> value of 0. It's a serial number, so it increments with each post.</p> <h4>Other fields</h4> <p>You can use the <i>twitterScreenName</i> field to identify the user.</p> <p>The <i>when</i> field is when the post was created. </p> <p><i>text</i> is the contents of the big edit box. It's used in the <i>description</i> element of the RSS item that represents the post. </p> <p><i>idTweet</i> is only present if the item has been posted to Twitter. You can turn off posting to Twitter through the Platforms panel in the Radio3 settings dialog, even though you must be signed in to Twitter to use Radio3. So you can't depend on <i>idTweet</i> being there. </p> <p><i>guid</i> is the value of the guid sub-element of item in the user's RSS feed.</p> <p>I'm pretty sure the meaning of the other fields is self-evident. If there are questions, please post a comment below.</p> <h4>Identifying a post</h4> <p>The combination of <i>twitterScreenName</i> and <i>when</i> uniquely identifies a post.</p> Sat, 13 Sep 2014 19:18:55 GMT Radio3 v0.54 is more robust <p>When <a href="">Radio3</a> starts up, if there's a failure to connect with the server, rather than present a confusing display with no posts in the history table, we show a simple message saying there was a failure to connect with the server, and ask that the user reload the page.</p> <p>This can happen when you have a bad Internet connection or when the server crashes. Which happens sometimes. It's usually a matter of a few seconds before it reboots. (Like Radio3 the server is new software, and hasn't been fully burned-in yet.)</p> <p>Here's what the <a href="">screen</a> looks like. </p> <p>Thanks to Michael Lopez for great <a href="">help</a> tracking down this issue. </p> Fri, 12 Sep 2014 15:59:12 GMT Radio3 0.53 has a simple API <p><i>This is an advanced technical feature, primarily for developers at this time.</i></p> <p>What if you want to hook your <a href="">Radio3</a> flow into a service that we don't have built-in support for? You can always use the RSS feed to make the connection, but then you have to poll the feed to see when it updates. That seems inefficient.</p> <p>So there's a new feature in 0.53 that allows you to specify the URL of a service that we will ping whenever the RSS feed updates. It sends along one parameter, the URL of the feed. </p> <p>There's a new Advanced settings <a href="">panel</a> where you can enter this URL.</p> <p>Please don't post comments about this feature on the main mail list, if you have questions post a comment here. If there's enough interest we'll start a Radio3 developers list. </p> <h4>More info</h4> <p>The URL you provide must be of the form:</p> <pre></pre> <p>In other words, all we do before calling it is add the URL of the user's feed to the end of the string you provide. If you don't include the ?url= (or whatever you call the param) then it won't work.</p> Thu, 11 Sep 2014 17:44:17 GMT Radio3 0.52 does podcasts <p>If you want to include a podcast with your <a href="">Radio3</a> feed, this is what you do.</p> <ol> <li><p>Paste the URL of the media file in the enclosure section of the Radio user interface. <a href="">Screen shot</a>. </p></li> <li><p>Publish the item.</p></li> </ol> <p>That's it. Radio3 will automatically figure out how big the enclosure is and what its type is and include it in the feed. </p> <p>When the item shows up in the history table, there will be a <a href="">headphone icon</a> next to the other icons. It links to the media file.</p> <p>Note that the enclosure link will not be sent to Twitter, Facebook or WordPress. If you want the link to be sent, repeat it in the link field of the Radio3 user interface.</p> Thu, 11 Sep 2014 13:46:16 GMT Radio3 v0.51 <h4>Editing WordPress and Facebook posts</h4> <p>In Radio3 v0.51, if you edit a post that was sent to Facebook and/or WordPress, when you save changes, the Facebook and WordPress posts are updated too. </p> <p>Unfortunately we can't do this for items that were sent to Twitter, there is no provision for updates in the Twitter API. </p> <p>As a result, there is no 140-char limit on updates. Here's a <a href="">screen shot</a> showing a post that I'm updating for WordPress and Facebook.</p> <p>Of course the changes flow to your RSS feed, as before. </p> <h4>The Link column of the history table</h4> <p>The Link column of the history table now connects to the full URL and displays the domain that it points to. This is more informative than what was there before, the hash code of the shortened URL. <a href="">Screen shot</a>.</p> <h4>New items in the Docs menu</h4> <p>I try to keep the Docs menu full of links to things people ask about frequently.</p> <p>So if you have a question about <a href="">Radio3</a>, look there first. You might save time.</p> Tue, 09 Sep 2014 16:07:34 GMT Radio3 v0.50 <p>When you go to <a href="">Radio3</a> the first time, instead of seeing a blank screen, now there's three paragraphs worth of instructions and an explanation of what the product does and its philosophy. When you sign on to Twitter, this is replaced with the edit box and history table.</p> <p>Here's a <a href="">screen shot</a> of the new sign-on screen.</p> <p>You can test it by signing off Twitter, and signing back on.</p> Mon, 08 Sep 2014 18:56:54 GMT Radio3 v0.49 works with WordPress <p>As you know, <a href="">Radio3</a> is a cross-platform linkblogging tool that works with Facebook, Twitter, and posts to a feature-full RSS feed. Now, with this release, we add WordPress to the list of publishing surfaces for Radio3. </p> <h4>Setup</h4> <ol> <li><p>In the System menu (at the right edge of the menu bar) choose <i>Settings.</i> Click on the WordPress panel, <a href="">screen shot</a>. </p></li> <li><p>Enter the address of your WordPress site, your username and password. We only use this information to post to your site, when you tell us to do so. The login information is stored on our server. </p></li> <li><p>In the <i>Platforms</i> panel, click the <a href="">checkbox</a> for posting to WordPress.</p></li> </ol> <h4>How to</h4> <p>Use Radio3 exactly as before. Now your links will flow to your WordPress site as well as the other surfaces you've enabled.</p> <h4>What is posted</h4> <p>The text of the post goes in the title of the WordPress post, and the link goes in the body. I tried to mirror the behavior of Radio3 with Facebook and Twitter. It's pretty amazing how well today's WordPress deals with embedded media. </p> <h4>Example</h4> <p>Here's a post I sent to <a href="">Facebook</a>, <a href="">Twitter</a> and <a href="">WordPress</a>.</p> <h4>Questions, problems?</h4> <p>Please report any problems on the <a href="!forum/radio3">mail list</a> or in a comment here. </p> Mon, 08 Sep 2014 13:55:03 GMT Radio3 v0.48 <p>In this release, as an experiment, we send full links to Twitter, not shortened links.</p> <h4>How it happened</h4> <p>I was going to fix a bunch of problems related to link shortening, thereby making the code more complex. But then I remembered, from my experience with <a href="">Little Pork Chop</a> that these days shortening links doesn't do much, other than hide the URL from the reader, and add another level of indirection. So I tried an experiment to see if it would work if I sent the full link, even if it was very long, and of course it did. </p> <p>Please watch carefully for any problems, and report them on the list.</p> <h4>Entering posts by-hand</h4> <p>I also tested creating a post by going directly to <a href="">Radio3</a> and entering the text and link manually, without using the bookmarklet, and it now works in this mode as well.</p> <h4>Being conservative</h4> <p>For now, we're still generating the short link, you'll see it in the Link column in the history table. But if this stands up, I imagine that will be taken out of the product sometime soon. </p> Sun, 07 Sep 2014 14:23:09 GMT Radio3 v0.46 <p>I know there are a few serious programmers using Radio3, so I'm going to explain what I've learned about possible sources of the data-losing bug we're seeing.</p> <h4>Crucial places</h4> <p>There are two places where the contents of your storage can change. </p> <ol> <li><p>When you post something.</p></li> <li><p>When you change settings.</p></li> </ol> <p>So just before doing both those things, the app reloads the data. On a reasonable net connection this takes about 1/4 second. Not something to worry about.</p> <p>The other place Radio3 loads the data is at startup.</p> <h4>I found a race condition</h4> <p>I'm carefully analyzing how it works, and I've found one place where there's a race condition, where theoretically we can update the data before it's been loaded. That's is almost certainly how we're losing data.</p> <p>In the v0.46, that race condition is eliminated. </p> <h4>One more robustness change</h4> <p>Now there's another thing I'm doing that should make the data loss impossible, at least this way. A bit of sloppy too-quick programming, meant that if it fails to load the data, it wipes it out. I think this is less likely than it sounds, but I've fixed this too. Instead of continuing after an error (the sloppy programming), it puts up an unmissable error dialog, which relays the message from the server, and asks the user to reload the page.</p> <p><img src="" width="582" height="294" border="0" style="" alt="A picture named dialog.gif"></p> <p>Instead of losing data, you'll get the dialog. I'm hoping people will take a screen shot of the dialog, if they see it and post it to the list. </p> Sat, 06 Sep 2014 15:50:16 GMT Radio3 works with Facebook <p>Now we can officially unveil <a href="">Radio3</a> -- my newest linkblogging tool. </p> <h4>Facebook, Twitter and RSS.</h4> <p>It's a cross-platform linkblogging tool.</p> <p>The idea is to start a great flow of news to Twitter and Facebook, while enabling new networks to boot up on the open web, building on the RSS support. </p> <p>When you post using Radio3, you're helping a new <i>open</i> web news network boot up. It's like using solar or wind energy, or riding a bike instead of driving. It's good for the environment. <i class="fa fa-smile-o"></i> </p> <h4>Getting started</h4> <p>Here are the <a href="">instructions</a> for getting started with Radio3. </p> <h4>It has history too</h4> <p>The first Radio was <a href="">Radio UserLand</a> released in 2002. The second was <a href="">Radio2</a>, a server-based linkblogging tool that ran in the OPML Editor environment. Until last Friday I did all my linkblogging in Radio2. Radio3 is a browser-based JavaScript app with a thin server that runs in Node. The 3rd Radio is by far the best, but of course I'm biased.</p> <h4>The Supremes want to sing for you</h4> <iframe width="560" height="315" src="//" frameborder="0" allowfullscreen></iframe> <h4>Support</h4> <p>Here, in a comment, or on the new <a href="!forum/radio3">Radio3 mail list</a>. </p> Fri, 05 Sep 2014 23:13:49 GMT Recent tweets list <p>I was curious to see what people were posting through Radio3 so I whipped up a quick app to produce a reverse-chronologic list of tweets. </p> <h4>The list</h4> <p>This is where the list is...</p> <p><a href="" target="_blank"></a></p> <p>It is interesting. However there's a caveat.</p> <h4>Caveat</h4> <p>Centralized resources like this tend to flame out. At the first sign of trouble, someone using this list to complain about Radio3 or about some individual (most likely me) I'll take the application down. So don't use this as a way to stink things up, and expect it to have a short life, and you won't be disappointed. <i class="fa fa-smile-o"></i></p> <h4>You can leave it open</h4> <p>If you leave the page open, it'll look for new stuff once a minute and insert it at the top.</p> Thu, 04 Sep 2014 14:35:22 GMT Questions? <p>If you have a question about using <a href="">Radio3</a>, please post it here. <i class="fa fa-smile-o"></i></p> <p>You can also use the <a href="!forum/radio3">support mail list</a>. </p> Tue, 02 Sep 2014 13:14:53 GMT Radio3 has a philosophy <p>The idea is to start a great flow of news to Twitter, Facebook and WordPress, while enabling new networks to boot up on the open web, building on the RSS support. </p> <p>When you post using <a href="">Radio3</a>, you're helping a new <i>open</i> web news network boot up. It's like using solar or wind energy, or riding a bike instead of driving. It's good for the environment. <i class="fa fa-smile-o"></i> </p> Tue, 02 Sep 2014 13:06:18 GMT Getting started with Radio3 <p><a href="">Radio3</a> is a cross-platform linkblogging tool. Your links go to Facebook, Twitter and a new feature-full RSS feed that will make it possible to build new innovative networks on the open web web. </p> <h4>Setup</h4> <ol> <li><p>When you go to <a href="">Radio3</a> for the first time, click <i>Sign on here</i> in the right corner of the menubar. Choose <i>Sign on Twitter</i> in the menu. </p></li> <li><p><a href="">Authorize</a> Radio3. </p></li> <li><p>Choose <i>Sign on Facebook</i> to authorize Facebook. <i>Note: Until they approve the app, posting to Facebook won't work. </i></p></li> <li><p>Choose <i>Bookmarklet howto</i> in the Feed menu for instructions on installing the bookmarklet. </p></li> </ol> <h4>How to post a new item</h4> <p>Find a news story you want to share with your followers. </p> <ol> <li><p>Click on the bookmarklet.</p></li> <li><p>Edit the text.</p></li> <li><p>Click Submit.</p></li> </ol> <p>Repeat.</p> <h4>We only post</h4> <p>We post the items you tell us to. We don't read your tweets, or see who you follow, or follow new people or update your profile (all things Twitter would allow us to do). </p> <h4>Your feed</h4> <p>To see your RSS feed click on the orange RSS icon next to the Submit button or choose <i>Linkblog feed</i> in the Feed menu.</p> <p>To see your linkblog home page, choose <i>Linkblog home</i> in the Feed menu.</p> Mon, 01 Sep 2014 19:44:44 GMT Bookmarklet howto <p>The bookmarklet is an essential part of Radio3. </p> <p>To install it, drag the "R3" link below into the toolbar of your browser. </p> <p><a style="font-family: Ubuntu; font-size: 28px; font-weight: bold; line-height: 160%; margin-left: 3em; margin-bottom: 30px;" href="javascript:(function(){''+encodeURIComponent(location.href)+'&amp;title='+encodeURIComponent(document.title)+'&amp;description='+encodeURIComponent(document.getSelection())); })();">R3</a> </p> <h4>Using the bookmarklet</h4> <p>When you're on a page you want to link to, click the bookmarklet. Radio3 will open with the fields of the dialog filled with the title of the page. The link is included, along with a shortened version for Twitter posts. </p> <h4>Questions</h4> <p>The toolbar works differently in each of the browsers. If you have questions, post them here and we'll try to get the answer. </p> Sat, 30 Aug 2014 12:49:29 GMT Support info for Radio3 users <p>Privacy</p> <ul> <li>Radio3 does not receive your login information for Facebook. </li> <li>Your preferences are stored on our server, but they are stored in a private space on Amazon S3. We can access these preferences. </li> <li>We don't receive your Twitter password, but your credentials pass through our server. We maintain a copy in a cache, but only use that for performance purposes.</li> </ul> <p>User support</p> <ul> <li>Support is provided on the <a href="!forum/radio3">radio3 mail list</a> on Google Groups.</li> </ul> <p>Terms of service</p> <ul> <li>Use the software to post links to any of the services we support. We reserve the right to cancel the service at any time, for any user, for any reason, or for all users, without notice. Only use it for legal purposes.</li> </ul> Fri, 29 Aug 2014 18:35:23 GMT