diff --git a/typescript/types/messages.d.ts b/typescript/types/messages.d.ts
new file mode 100644
index 0000000000..74d5b735cc
--- /dev/null
+++ b/typescript/types/messages.d.ts
@@ -0,0 +1,27 @@
+declare module Messages {
+	type ImageString = string;
+
+	type EventMusicState = {
+		t: "musicstate",
+		state: "play" | "pause" | "stop" | "",
+		position: number, // seconds
+		shuffle: 0 | 1,
+		repeat: 0 | 1,
+	};
+
+	type EventMusicInfo = {
+		t: "musicinfo",
+		artist: ImageString,
+		album: ImageString,
+		track: ImageString,
+		dur: number, // duration
+		c: number, // track count
+		n: number, // track number
+	};
+
+	type Event = EventMusicState | EventMusicInfo | { t: unknown };
+
+	type Music = EventMusicState | EventMusicInfo | {};
+
+	var music: Music;
+}
diff --git a/typescript/types/modules.d.ts b/typescript/types/modules.d.ts
index 628074d114..e9f07b9651 100644
--- a/typescript/types/modules.d.ts
+++ b/typescript/types/modules.d.ts
@@ -9,3 +9,4 @@ declare function require(moduleName: "power_usage"): PowerUsageModule;
 declare function require(moduleName: "exstats"): typeof ExStats;
 declare function require(moduleName: "time_utils"): typeof TimeUtils;
 declare function require(moduleName: "textinput"): typeof TextInput;
+declare function require(moduleName: "messages"): typeof Messages;