You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- Follow the instructions in the [superbird-tool repository](https://github.com/Car-Thing-Hax-Community/superbird-tool) to flash your CarThing device with the necessary image.
143
-
> If you need help, refer to the [detailed instructions](#flashing) at the end of this page
144
-
145
-
2.**Get the installer**
146
-
*should be under [releases](https://github.com/ItsRiprod/DeskThing/releases)*
147
-
148
-
- Run the 'deskthing-0.*.*-*-setup.*' installer on your computer
149
-
150
-
3.**Check for your device:**
151
-
- Under the 'Devices' tab, ensure your device shows up. If it does not, join the Discord server and report the issue, this can be buggy on some machines.
152
-
> A few things to try if it isn't working is to 1: Use task manager to kill all instances of ADB 2: Run DeskThing as administrator 3: Unplug and plug in your Car thing 4: Install ADB and manually check with `adb devices`
153
-
- If the device shows up, go to the 'Client Downloads' tab and click the latest version. It should show up at the top (Staged: Deskthing CLient)
154
-
- Go back to the 'Devices' tab and click 'Push Staged Webapp' It should take a second, and then your Car Thing should restart.
155
-
4.**Load Apps**
156
-
- Congrats! You're basically done. Now go to 'Apps' and then 'Webapps' and download any apps you want. Ensure you check dependencies before doing so as this could cause errors.
96
+
Updating this ReadMe with the updated flashing / installation instructions was tedious and led to confusion
157
97
158
-
> Any Issues? Contact me [through the Deskthing discord server](https://deskthing.app/discord) or via DMs to @riprod
98
+
So now, it is contained inside an easy youtube video
159
99
160
-
⚠️Note for MacOS⚠️
161
-
162
-
First, when you install the DeskThing installer, you'll need to run
Finally, the image linked above won't always work for MacOS. So instead, use the following image (it is a discord download for now) as it fixes ADB for MacOS
174
-
175
-
**Go to Releases -> MACOS LISTEN UP to find the updated link**
176
-
*Discord will cycle the url for the link so this one will expire after a given amount of time*
177
-
[The new location is on thingify.tools. Use v8.9.2](thingify.tools)
178
-
179
-
Thanks! Have a good day
100
+
https://www.youtube.com/watch?v=iW2biAnq0n8
180
101
181
102
</details>
182
103
183
104
---
184
105
185
-
<details>
186
-
<summary>
187
-
<h2>📸Flashing</h2>
188
-
</summary>
189
-
190
-
<imgsrc="readme_images/bar.svg"style="width: 100%;"alt="Click to see the source">
191
-
192
-
[Alternative flashing tutorial for Windows](https://youtu.be/Y0paq_qhG5M?si=YcpNOJzzQu8MJJTb)
193
-
194
-
**_It is HIGHLY recommended to use the new ifixit tutorial_**
- Go to superbird-tool and install it based off your operating system. Come back once you can run `python superbird_tool.py --find_device` and see your Car Thing
204
-
- Unplug the Car Thing
205
-
- Hold buttons 1 and 4 (the four large top buttons are mapped from left to right) and plug it in.
206
-
- Wait a few seconds. If the screen does not turn on, that means you are in boot mode. You can release the buttons
207
-
- Run `python superbird_tool.py --burn_mode` to enter burn mode
208
-
> Note: This step may say it fails to enter burn mode. This is okay, continue on as if it worked. There is information in the discord as to why this is.
209
-
- Download 8.9.2-thinglabs.zip files from Thingify Tools (linked above) and in that same folder (unzip them)
210
-
- (Windows only) Download [zadig](https://zadig.akeo.ie/) and install the WinUSB driver for **GX-CHIP** (select it and click "Install Driver")
211
-
> Alternatively use **libusbK** if it does not work
212
-
> you may have to click "Show All devices" to see it
213
-
- Run `python superbird_tool.py --restore_device /path/to/extracted/firmware/folder` (This may take a while)
214
-
- After the firmware is flashed, the Car Thing should be ready with ADB enabled. To check, run `adb shell ls -l /usr/share/qt-superbird-app/` and you should see webapp as one of the folders.
215
-
- Ensure that `adb devices` works and registers `whateveryouridis device` as one of the options
216
-
- Continue setup from [here](#detailed-setup-instructions)
217
-
218
-
</details>
219
-
220
-
---
221
106
222
107
## 📗 Additional Resources
223
108
@@ -231,31 +116,6 @@ Process:
231
116
232
117
> Questions? DM me on discord @riprod
233
118
234
-
⚠️ *While bricking the Car Thing is extremely difficult - I don't think anyone has done it yet - the possibility is still there. I do not take any responsibility for damages done to the device. Try to use common sense* ⚠️
235
-
236
-
237
-
# Developing Apps
238
-
Interested in developing an app? Well here's a great place to start! Make sure you join the DeskThing discord server so I, or anyone else, can help you out!
239
-
240
-
Start with
241
-
```sh
242
-
npm create deskthing@latest
243
-
```
244
-
And follow the prompts to set up the app environment. From there, you can reference:
These are apps that make the deskthing "firmware" functional! When you use spotify on your deskthing, it's using the spotify app (linked here). What you interact with is driven by the "src/App.tsx"
This is what allows deskthing apps to "function". When you hit the pause button on the spotify app, it makes a request to the deskthing-client which routes your request (through the deskthing-app-client package, source code linked here). This deskthing-app-client request doesn't return a response, instead it listens for events through the deskthing-app-client using the "on" method.
This is what allows the deskthing-server to make custom requests. When the deskthing-server gets a request to pause the current spotify song, it forwards that action through the deskthing-app-server back to the spotify apps "server/index.ts" which can be handled in your app using the deskthing-app-server "on" method to respond to custom requests from the deskthing-client.
254
-
255
-
### [The client that goes on the Car Thing](https://github.com/ItsRiprod/deskthing-client)
0 commit comments