SDKs and Tools

Nothing to install. One line of HTML.

<script src="https://timtim.live/widget/events.js"
        data-city="Miami" data-category="music" async></script>

Every option →

@timtim-live/events — no dependencies; works in browsers, Node 18+, Deno and edge runtimes. No key = sample events.

npm install @timtim-live/events

import { TimTimEvents } from "@timtim-live/events";

const timtim = new TimTimEvents({ apiKey: "tt_test_..." }); // leave the key out for sample events

const { events } = await timtim.events.list({ city: "Miami", category: "music" });
for (const event of events) console.log(event.name, event.tickets.buy_url);

Not on npm yet — the install line works once it is. Today, plain fetch does the same: see how.

<timtim-events> — an HTML tag you can style and control from your own code. TimTim.Live hosts the open-source build, so it works today with no install.

<script src="https://timtim.live/embed/v1/timtim-events.js" defer></script>
<timtim-events location="Miami,US" category="music"></timtim-events>

Build yours with every option →

From npm, once published: @timtim-live/web-component

<script type="module">import "@timtim-live/web-component";</script>
<timtim-events city="Miami" category="music" limit="6"></timtim-events>

Not on npm yet — the install line works once it is. The hosted widget above works today.

@timtim-live/react — built on the same SDK, so it never behaves differently.

import { TimTimEvents } from "@timtim-live/react";

export default function Events() {
  return <TimTimEvents city="Miami" category="music" />;
}

Not on npm yet — the install line works once it is.

A block and a shortcode, with a preview and a connection test. Download it from timtim.live; it updates itself from there. It is not on WordPress.org.

Download the pluginInstallation guide

Source code

timtim-live-events on GitHub