Inthing supports a variety of event types, which display different kinds of information (text, code, images etc) on your stream.

When you successfully post an event with one of the methods in inthing.Stream, you will get back a inthing.Result object, which contains a url attribute, and a inthing.Result.browse() method.

Here’s an example of using the Result object:

from inthing import Stream
stream =
result = stream.text('my first event!')
print("opening {}".format(result.url))

See Event Types for a description of the event types.


Events have an associated priority value which is an integer between -2 and +2 (inclusive).

Priority values
Value Meaning
+2 Urgent
+1 Important (of greater than normal signficance)
0 Normal priority (default)
-1 Informative
-2 Verbose


Most events will have a description field. You can set how the description should be displayed via the markup parameter.

Supported markups
Markup Meaning
text Simple text
markdown Markdown.
html Simple HTML
bbcode BBCode.

Note will strip descriptions of potentially dangerous markup, such as <script> tags.

Capturing Output

Inthing can automatically capture output from your Python script or application. It does this by hooking in to your apps standard output and standard error, i.e. anything you print to the terminal.

Here’s an example:

from inthing import Stream
stream =
with stream.capture(title="Capture all the things!") as capture:
    print('Anything you print will get captured...')

In the above code, any print statement inside the with blog will be captured. The text will still appear in your terminal, but when the with block exists, inthing will upload a new event.