The Revit Project As a Tweeter(sic) Using Dynamo (In Four Steps)

Dynamo is to Architects & Designers what Scratch is to toddler geniuses learning to code. It gets us thinking in terms of manipulating the machine in terms of instruction sets rather than punching individual commands at the computer all day. More importantly, it is a platform that is designed to span between the world of coding and the world of assembling architecture. This, by definition, makes this extensible in both directions, seemingly without limits.

The Case for a Project Twitter

Personally, I'm not a tweeter (sic), but after a recent natural disaster, it was the only place to gather information about loved ones in a particular neighborhood. A typical architectural project is not a place where random strangers gather for a round of Kumbaya. However, a platform such as Twitter certainly breaks barriers when broadcasting to a team or a group. It could be anything from a gentle reminder, a recently discovered piece of vital information, or, live tweeting meeting notes. With Dynamo's Iron Python Interface and the ability to add  .dll libraries, along with Twitter's well documented Application Programming Interface (API), the rationale for building a connection between Twitter and the Revit Project quickly went from 'Is there a need?' to 'Why not?'.

The Process

As of the writing of the post, Dynamo does not have a package to retrieve Twitter timelines. PYTHON on the other hand had plenty of easy-to-use libraries to run circles around the twitter library. 'It would be a One-day fun project' I thought. It was... Until I discovered that the beloved 'Tweepy' library for Python does not work for Iron Python that Dynamo allows. I spent three days scouring google and attempting all sorts 'pip' installs - but to no avail. Finally, I gave up and went to my go to code kitchen: Visual Studio using C#. I had recently discovered that Dynamo had a Zero-Touch Plug-in environment that lets one import *.dll libraries and leverage their functionality. After finding a sufficiently simple library (Tweetinvi), I set to wrap the simple instruction sets so that it can work seamlessly with Dynamo.

00. Getting Started:

If you would like to try this on your own, you will need to import the Dynamo Twitter Connector. Unfortunately, I don't have this as a published package, but you are welcome to download the build the connector from GitHub source. Alternatively, you can simply download the Binaries (Debug) folder. Then you can 'Import Library' from the Dynamo 'File' menu to have the Connector show up in the tool palette.

01. Authentication: 

In order to connect to Twitter, Twitter needs to know who we are. Basically this involve creating an 'App' via your twitter account. You can do so by going to https://apps.twitter.com/ and signing in.
After, we can create four keys: the consumer key, consumer secret, access token, and access token secret.

02. Retrieving Time Lines:

Once you are authenticated, the rest is relatively simple from a coding perspective. All that is left to do is to hook-up your Dynamo Nodes to retrieve and convert tweets in your time line to a string.

03a. Displaying Time Lines:

This step involves setting up a 'Text' parameter in a Generic Annotation Family and hooking it up to the output of the previous step. Strangely, I'm finding that it is not easy to select annotation families in Dynamo. I had to jump through a couple of hoops - but it was the least of my problems.

03b. Tweeting from Revit:

Tweeting from your Project is a breeze with the 'Publish Tweet' node.