- C# 77.6%
- PHP 17.2%
- PowerShell 2.3%
- CSS 1.6%
- Python 0.7%
- Other 0.6%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| app/PartsDesk | ||
| installer | ||
| release-notes | ||
| scripts | ||
| server | ||
| .gitattributes | ||
| .gitignore | ||
| build.ps1 | ||
| README.md | ||
| release.ps1 | ||
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>.exefrom the releases. Nothing else is needed. -
Debian, Ubuntu, Mint, Kali, Pop!_OS… (64-bit): download
partsdesk_<version>_amd64.deband open it with your software installer, or:sudo apt install ./partsdesk_*_amd64.debParts 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/PartsDeskis 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.AppImageOn 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, installfuse3(orlibfuse2on older distributions), or start it with--appimage-extract-and-run.
Getting started
- Add where things are kept with + Location (left, under the tree). Use Inside to nest them.
- Select a location and click + New part (Ctrl+N). Changes are saved as you type.
- Have a spreadsheet already? Settings › Import from CSV. It needs a
Namecolumn and also readsCategory,Model,Quantity,WarnBelow,Location,Tags,Url,DatasheetandNotes.
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.exeunder 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.