Skip to content

Warehouse Desktop

The Warehouse Desktop Application is available for different OS platforms:

  • Debian-based OS (amd64, arm64) .deb
  • macOS .dmg
  • Windows .exe Installer

Detailed description of how to work with the Warehouse Desktop application

Main window, warehouse tab level 0

Main window, Warehouse tab, Level 0 - Locations (rooms)


Tab "Warehouse"

The application starts on Warehouse tab, whitch displays locations (rooms). On this tab, users can add new location, edit a location name or remove a location via a confirmation modal.

The Refresh button allows user to get updated data from the database. This is a convenient d=feature for teamwork.

The "Add Location" button opens a small modal to type the name of a new location. The button with the pencil icon allows changing the name of an existing location.

Create a new Location Rename a Location
The same controls for creating end editing also exist on the next levels

The "Show Details" button redirects to the next level to show racks in the room.

Location (room) details

Racks in the room
Main window, Warehouse tab, Level 1 - Racks in the room

At this level, the application displays room capacity. In the demo screenshot, there are two racks, with brief details about the bumber of shelves. User can add a new rack, edit existing one, or remove it throught a confirmation modal. The Refresh button works the same way as on the previous level.

The "Show Details" button redirects to the next level to show shelves in the rack

Rack details

At this step, user can define place the box position on the shelf. To move a box, use the drag-and-drop method.

Shelves of the rack
Main window, Warehouse tab, Level 2 - Shelves of the rack

This view displays the main operations with boxes on the shelf. At this step, user can change the rack configuration:

  • Change the Rack name
  • Set the number of shelves in the rack
  • Set the name of shelf
  • Set shelf capacity (the number of boxes in a row and the number of rows)

Create a new Location Rename a Location
Shelf settings. Rack settings.

View Box details

To view box details, click on a box on the shelf. The right side of the window will display a photo of the box (if it was upload earlier), button controls, and a list of items with photos (if uploaded earlier).

Box Details
Box Details with items

View Box items as list and grid

Modal view for items in the box. In this modal, user can change the image size and display type (list / grid).

Box Details
Items in the box modal list view
Box Details
Items in the box modal grid view

Box operations - Add new box

At this step, the application allows adding a new container with items (a box). To add a new box, double-click on an empty space [+]. This opens a new modal to add details and contents of the box.

Add new box modal
Modal to add a new box with items.

Box operations - Edit box

This modal opens by double-clicking on a box on the shelf. In this modal, user can move the box to another location, rack or shelf. User can also change the box name and photo, view items, change their names or quantities, change item photos or remove them. User can add a new item with its quantity, name and photo.

Edit box modal
Modal for edition an existing box.

Tab "Find"

On the Find tab, user can search for items and boxes by name. The search also works wiith partial names, as show in the screenshot.

Find tab and search results
Search results.

Tab "Find" - Navigation

By clicking on a box name, the user is navigated to the first tab, which opens the box details and highlights the selected box. The user can also return to the Find tab to view previous search results and navigate to another box in the list.

Edit box modal
Navigated to the found box.

Tab "Settings"

On this tab, user can change the application configuration.
User can set the database to remote (using Warehouse Standalone Server or another copy of the Warehouse Desktop Application) or local.
The local database is kept in `USER_DIR/warehouse/warehouse.db` by default, which is an SQLite database file. Users can create a new database or specify another database file directly from this tab.
All photos kept in `USER_DIR/warehouse/photos/` by default. Users can also change the photos directory on this tab.

Settings tab
Settings tab.

Switch to a remote database

To use a remote database, user can use Warehouse Standalone Server or another copy of the Warehouse Desktop Application running in server mode.

Display Settings

Enable Display contain of boxes to show item names directly on the box.
Supported Languages:
  • German
  • English (by Default)
  • Spanish
  • French
  • Italian
  • Polish
  • Ukrainian
Display boxes with items name
The Display contain of boxes feature enabled.

Tab "Server"

On this tab, users can activate the built-in web server for warehouse inventory management.

Server Tab
Server tab.

The user's PC and mobile device must be connected to the same local network for this feature to work correctly.
The user need to choose the port number (Default is 4200) and set an Admin password (default: 12345) to activate the server.
Once the server is activated, the application displays a QR code and a link to open the web interface for inventory tracking.

Web application to inventory
Web application for warehouse management.
After scanning the QR code, the web interface opens on mobile device for taking inventory, where users can add a new location (room), a new rack, boxes and items. When adding a box, the application allows taking a photo using the device camera.
Read details about the Inventory web app
Read details about the Admin Panel web app

Use Desktop App as a Server

Server-Clients diagram
Diagram 1: Use Desktop App as a Server.

The application can be used as a server within a network if running the Warehouse Standalone Server is not possible.
In this case, one copy of the application (starting from v1.7) acts as a Master, and other application connect to it using its IP address and port.

Setup Desktop Application as a server

Steps to set up the Desktop Application as a server:

  1. Run the Desktop application on the first PC (this will be the Master app).
  2. Set up the local database and photos folder for proper operation. (View Settings Tab)
  3. Specify the port and start the server. (View Server Tab)
  4. Note the IP address and port number displayed under the QR code.

Connect Slave Desktop Apps to the Master Desktop App

Steps to set up the Desktop Application as a Slave:

  1. Run the Warehouse Desktop application on other PCs and go to the settings tab.
  2. Switch to Remote databese.
  3. Enter the IP address and port (e.g., http://192.168.1.100:4200).
  4. Click the Connect button (the application will reload).
  5. Slave Settings
    Slave Desktop App Settings
  6. After reloading, the application will use the Master application as its server.
  7. Slave Connected to master
    Slave Desktop App successfully connected to the Master Desktop App.