MCPcopy Index your code
hub / github.com/ItsRiprod/DeskThing

github.com/ItsRiprod/DeskThing @v0.11.17

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.11.17 ↗ · + Follow
1,756 symbols 5,147 edges 436 files 253 documented · 14% updated 7mo agov0.11.17 · 2025-08-13★ 1,16718 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Youtube Banner image

Quick Links

Reddit Link

📃Trello Board

💬Deskthing Discord

🌐Official Deskthing Website

📺 Deskthing Youtube Channel

💬 Car Thing Hax Community Discord


‼️DeskThing is completely free to use but donations are greatly appreciated ☕


The DeskThing ✔️

Let's begin, shall we?

This is the DeskThing project. Using Spotify's existing Car Thing, the DeskThing makes the perfect desk assistant. In short, the DeskThing serves as an alternative OS for the Spotify Car Thing. It allows you to load up community-made apps to it to do anything from control your local audio to seeing who is in your discord call! This is an open source project made by me, Riprod, an independent developer who's not even out of college! If you want to help contribute to this endeavor and attempt to revive the car thing, you can do so through my buymeacoffee link or through Github Sponsors.

Cheers!

Dammit Jeff posted a video covering the DeskThing! Check it out here

⚠️DO NOT PULL MAIN BRANCH TO INSTALL ⚠️

Instead, go to The Official Website and download the installer for your OS For a video walkthrough of v0.6.0, go to this video


All instructions are up-to-date as late of v0.9.0-beta. Later versions may differ in functionality and setup

✨ Features

Click to see the source

The DeskThing is a simple CarThing Chromium-based website that can communicate with a Desktop APP on your computer. The CarThing can:

Note: Not all of these are updated and are pending a revision. This is new as of v0.7.0

Features

  • All In One Package 📦

  • [X] Download apps directly from the Desktop App
  • [X] Manage and update the Car Thing's display
  • [X] Probably more - just check it out already

  • Configurable Controls ⚙️

  • [X] Make any button do any function!
  • [X] Control audio with the top buttons, front buttons, back buttons, really whatever you want!
  • [X] Modify them from the Desktop UI
  • [X] Add more directly from apps! (Basically, you can do anything) image The deskthing mappings page - will be updated in v0.12

App Highlights (View the rest on the deskthing website or in the app store in deskthing)

image

  • Spotify Integration 🎧

  • [X] Show currently listening (Album, Artist, Song name, album art)
  • [X] Control Spotify (Skip, pause, play, rewind, shuffle, repeat)
  • [X] Supports Podcasts too!
  • [X] Set Audio Output Source image LyrThing community app showing spotify lyrics by Espeon

  • Local Audio Control 🎧

  • [X] Show currently listening (Album, Artist, Song name, album art)
  • [X] Control Any Playing Media (Skip, pause, play, rewind, shuffle, repeat)

  • Custom Apps

    image

Gif uploaded via the Image Viewer app


  <h2>▶️ Setting Up</h2>

Click to see the source

Detailed Setup Instructions

Updating this ReadMe with the updated flashing / installation instructions was tedious and led to confusion

So now, it is contained inside an easy youtube video

https://www.youtube.com/watch?v=iW2biAnq0n8


📗 Additional Resources


Questions? DM me on discord @riprod

Action Shots

2024-11-03 14-52-17 2024-11-03 14_54_36 2024-11-03_14-49-12 2024-11-03_14_51_33 2024-11-03_14-54-50 2024-11-03_14_56_07

DeskThing wouldn't be possible without our sponsors

helium-badge

Want to support deskthing? You can here!

Extension points exported contracts — how you extend this code

CacheableStore (Interface)
(no doc) [15 implementers]
DeskThingServer/src/shared/types/types.ts
TimeStoreClass (Interface)
(no doc) [6 implementers]
DeskThingServer/src/shared/stores/timeStoreClass.ts
StoreInterface (Interface)
(no doc) [25 implementers]
DeskThingServer/src/shared/interfaces/storeInterface.ts
MusicStoreClass (Interface)
(no doc) [4 implementers]
DeskThingServer/src/shared/stores/musicStore.ts
PlatformInterface (Interface)
(no doc) [4 implementers]
DeskThingServer/src/shared/interfaces/platformInterface.ts

Core symbols most depended-on inside this repo

error
called by 377
DeskThingServer/src/main/services/events/progressBus.ts
log
called by 253
DeskThingServer/src/main/utils/logger.ts
on
called by 177
DeskThingServer/src/shared/stores/appStore.ts
warn
called by 171
DeskThingServer/src/main/services/events/progressBus.ts
getStore
called by 151
DeskThingServer/src/main/stores/storeProvider.ts
handleError
called by 115
DeskThingServer/src/main/utils/errorHandler.ts
emit
called by 107
DeskThingServer/src/main/services/events/progressBus.ts
get
called by 93
DeskThingServer/src/shared/stores/appStore.ts

Shape

Function 749
Method 746
Interface 155
Class 86
Enum 20

Languages

TypeScript100%

Modules by API surface

DeskThingServer/src/main/stores/appStore.ts39 symbols
DeskThingServer/src/main/stores/platformStore.ts38 symbols
DeskThingServer/src/shared/stores/mappingStore.ts34 symbols
DeskThingServer/src/main/stores/taskStore.ts31 symbols
DeskThingServer/src/main/stores/appDataStore.ts31 symbols
DeskThingServer/src/shared/stores/appStore.ts27 symbols
DeskThingServer/src/shared/stores/appDataStore.ts27 symbols
DeskThingServer/src/shared/stores/taskStore.ts26 symbols
DeskThingServer/src/main/stores/platforms/websocket/wsWebsocket.ts25 symbols
DeskThingServer/src/shared/stores/platformStore.ts23 symbols
DeskThingServer/src/main/stores/platforms/superbird/adbService.ts23 symbols
DeskThingServer/src/main/stores/platforms/websocket/wsPlatform.ts21 symbols

For agents

$ claude mcp add DeskThing \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page