No description
  • C# 77.6%
  • PHP 17.2%
  • PowerShell 2.3%
  • CSS 1.6%
  • Python 0.7%
  • Other 0.6%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-07 19:48:28 +02:00
app/PartsDesk Photo viewer: place the photo by size and position instead of a render transform, so it shows right on opening; arrow keys always step (1.34.2) 2026-10-07 19:48:28 +02:00
installer Linux installer: .deb package and AppImage "install to apps menu" (1.3.0) 2026-10-02 08:49:50 +02:00
release-notes Photo viewer: place the photo by size and position instead of a render transform, so it shows right on opening; arrow keys always step (1.34.2) 2026-10-07 19:48:28 +02:00
scripts More modules: ESP32 38-pin and S3 boards, Adafruit/SparkFun/Seeed libraries, forgiving search, ask the AI for a pinout (1.28.0) 2026-10-05 18:58:34 +02:00
server Gift-code and granted accounts are Honorary Hoarders, the owner is Chief Hoarder; paying supporters stay Supporters (1.34.1) 2026-10-06 06:41:48 +02:00
.gitattributes Self-hosted sync server as a Docker image; optional e-mail confirmation, owner CLI, trusted proxies (1.30.0) 2026-10-05 19:52:54 +02:00
.gitignore Sync across devices: PHP sync server and account sign-in in the app 2026-10-02 00:58:27 +02:00
build.ps1 Linux installer: .deb package and AppImage "install to apps menu" (1.3.0) 2026-10-02 08:49:50 +02:00
README.md Sync plans: free limits and Lemon Squeezy supporter subscriptions on the hosted server; self-hosted stays unlimited (1.31.0) 2026-10-05 20:19:29 +02:00
release.ps1 Linux installer: .deb package and AppImage "install to apps menu" (1.3.0) 2026-10-02 08:49:50 +02:00

Parts Desk

Keep track of your electronics parts on Windows and Linux: ESP32/ESP8266 boards, Raspberry Pis, Arduinos, GPS/NFC/LoRa modules, sensors, displays, capacitors, resistors and everything else, and exactly which box they are in.

Features

  • Locations as a tree: Workshop › Shelf 1 › Box A, drawer cabinets, bags, or a finished build ("Projects › CYD handheld") so you know where a part went. Each location shows how many parts it holds.
  • Box codes: give a box a short code (B12). Typing it in the search box, or scanning its QR label with a USB barcode scanner, jumps straight to that box.
  • Parts with name, category, model/part number, quantity (+/- buttons), "warn when below" for low stock, tags, shop link, datasheet link, notes and a photo (drop a file, or paste a screenshot with Ctrl+V)
  • Files per part: extra photos, pinout diagrams, datasheets and other documents, shown as thumbnails and chips; drop, paste or add them, open images in the built-in viewer and documents in their own app
  • Projects: builds and ideas with notes, the parts they need from the inventory (what you have and what is missing, take from stock / put back), diagrams and firmware files, and links
  • Diagram editor: draw wiring and block diagrams inside a project. Add components straight from the inventory (common modules such as ESP32, NEO-6M, RC522, BME280 and TP4056 come with their pins), drag from pin to pin to wire them (straight lines with square bends in their own lanes, or curves; colours follow the pin: power red, ground black, I²C blue/yellow), drag wire lines and add bends, add labels and notes, and export a PNG
  • Wiring checks and code: the diagram editor flags shorts, 5 V on 3.3 V pins, TX to TX, swapped I²C and ESP32 pins to avoid; net labels (GND, 3V3...) connect by name. Wiring & code gives the wiring table, pin definitions for Arduino, ESPHome and MicroPython, and the parts list (which can be added to the project)
  • Module pinouts: search 84 built-in pinouts of common hobby modules (ESP32 DevKit 30 and 38 pin, S3 DevKitC, C3 SuperMini, CYD, XIAO, NodeMCU, Nano, Pico, Pi header, NEO-6M, RC522, nRF24, LoRa, BME280, OLEDs, TFTs, TP4056, L298N, A4988...) plus about 2,250 parts from the Fritzing parts libraries of Fritzing and Adafruit (CC BY-SA 3.0), SparkFun and Seeed Studio (CC BY-SA 4.0). Not in the list? The AI from Photo AI can look up a board's pinout. Add a part straight from a module (+ From module...), give an existing part its pinout (Find pinout... in edit mode), or drop a module into a diagram. A part's pinout is shown on its card and used in diagrams
  • Shopping list: what's low on stock and what active projects are missing, by shop; tick what you bought to add it to stock
  • Prices, history and labels: optional prices (stock value, build costs), a history per part (taken for a project, moved, bought...) with the projects that use it, and printable A4 label sheets with QR codes for your boxes
  • Phone workbench: a project's checklist (tick it off on the phone), parts and wiring on your phone while you build
  • Shop orders and photo AI: paste an AliExpress / Amazon order (or the email) to add what you bought, with pack sizes and prices; or identify a part from a photo and/or text (shop title, model number) with Claude, OpenAI or Gemini (your own API key, kept on your PC only), or free with a local model in Ollama
  • Share a project as a read-only web page (notes, parts list, pictures, diagrams, links; never your stock), with a private link you can update or stop any time (needs a sync account)
  • Search across names, models, categories, tags, notes and locations; filter by location (including everything inside it), category or low stock
  • Phone photos: click 📱 Phone, scan the QR code and your phone shows the part selected on the computer. Take a photo and it is added straight away. "Next part without photo" (or the auto-next option) walks you through a whole box, and "Choose part" lets you pick parts from the phone. Works over your own Wi-Fi only, protected by a secret key in the code; nothing goes through the internet.
  • Move parts by dragging them onto a location (several at once with Ctrl/Shift), or pick the location in the details panel
  • Labels (Windows): "Make label" opens a ready-made label (name, code and QR code) in PTouch Desk for the Brother P-touch CUBE
  • CSV import/export (opens in Excel or LibreOffice); imports create missing locations from "Room / Shelf / Box" paths
  • Sync (optional): with an account at partsdesk.ttdk.eu (free accounts sync a limited number of parts and files; a small supporter subscription removes the limits) or on your own server, the inventory and its photos stay the same on all your computers. Changes are merged part by part; for the same part the newest edit wins. Sign in from Settings › Sync. The server is in server/; to run your own, use the Docker image tomtomdk/partsdesk-server.
  • Safe storage: one JSON file, saved automatically and atomically, with a daily backup (last 30 kept) and one-click restore. The data folder can be moved to OneDrive, Dropbox, Syncthing or a NAS, and the same file works on Windows and Linux.
  • System / Light / Dark theme, built-in updater, About and Log tabs

Install

  • Windows 10/11: run PartsDesk-Setup-<version>.exe from the releases. Nothing else is needed.

  • Debian, Ubuntu, Mint, Kali, Pop!_OS… (64-bit): download partsdesk_<version>_amd64.deb and open it with your software installer, or:

    sudo apt install ./partsdesk_*_amd64.deb
    

    Parts Desk appears in the apps menu. Updates install from the About tab (it asks for your password). Remove it with sudo apt remove partsdesk; your inventory in ~/.config/PartsDesk is kept.

  • Any other Linux (x86_64): download PartsDesk-<version>-x86_64.AppImage, make it executable and run it:

    chmod +x PartsDesk-*-x86_64.AppImage
    ./PartsDesk-*-x86_64.AppImage
    

    On first start it offers to add itself to your apps menu (copied to ~/Applications, no password needed); you can also do that, or undo it, from the About tab. It updates itself from the About tab. If it complains about FUSE, install fuse3 (or libfuse2 on older distributions), or start it with --appimage-extract-and-run.

Getting started

  1. Add where things are kept with + Location (left, under the tree). Use Inside to nest them.
  2. Select a location and click + New part (Ctrl+N). Changes are saved as you type.
  3. Have a spreadsheet already? Settings › Import from CSV. It needs a Name column and also reads Category, Model, Quantity, WarnBelow, Location, Tags, Url, Datasheet and Notes.

Keyboard: Ctrl+N new part, Ctrl+D duplicate, Ctrl+F search, Del delete, Ctrl+V paste a photo, Enter in search jumps to a box code.

Phone photos: if the phone can't connect

  • Phone and computer must be on the same network. Pick the right PC address in the phone window if there are several.
  • Allow Parts Desk in the Windows firewall prompt (private networks). If you dismissed it, allow PartsDesk.exe under Windows Security › Firewall › Allow an app through firewall. On Linux with a firewall (ufw, firewalld), allow TCP port 8765 (or the port shown in the phone window) from your LAN.
  • A VPN on the computer (e.g. Mullvad) blocks it unless local network access is allowed in the VPN app (Mullvad: Local network sharing).

Building

One codebase (Avalonia UI, .NET 8) for both systems. Requires the .NET 8 SDK and, for the Windows installer, Inno Setup 6. The Linux AppImage is built on Windows too; the top of build.ps1 lists the two small tools it needs in tools\.

.\build.ps1      # Windows exe + installer and the Linux AppImage (in installer\output)
.\release.ps1    # tags, pushes and publishes a release on Forgejo (needs release-notes\v<version>.md)

Settings live in %APPDATA%\PartsDesk on Windows and ~/.config/PartsDesk on Linux (or in the folder given by PARTSDESK_SETTINGS_DIR). The inventory defaults to inventory.json there, with photos/ and backups/ next to it.