1Introduction
PriceCalc is a professional production cost calculator for Windows. It helps you calculate the cost of raw materials, labour and additional expenses for any manufactured product, and automatically computes the final selling price including markup and VAT. All data is stored in a local database — only on your computer.
1.1 What PriceCalc does
- Accurately calculate the raw material cost of any product
- Track ingredient stock levels — automatically deducts quantities after each calculation using the FIFO method
- Save and reuse recipes for regularly manufactured products
- Calculate labour costs by labour type and time coefficient
- Apply a markup percentage and VAT to arrive at the final selling price
- Export calculation results to PDF or Excel
- Store a complete calculation history
1.2 System requirements
| Requirement | Details |
|---|---|
| Operating system | Windows 10 or Windows 11 |
| Internet | Required for licence activation; optional afterwards |
| Screen resolution | Minimum 1024×768; 1280×900 or higher recommended |
| Disk space | Approximately 70 MB (everything bundled in the .exe file) |
| Dependencies | None — Python, all libraries and Tcl/Tk are bundled in the .exe |
2Installation & first launch
2.1 Extracting the archive
You received a file whose name ends in .exe.7z (for example, PriceCalc_v1.2.0.exe.7z). This is a compressed archive — you need to extract it using 7-Zip before running the program.
PriceCalc_v1.2.0.exeOption A — 7-Zip already installed
How to check: right-click the .7z file — if you see a "7-Zip" entry in the menu, it is installed.
- Right-click
PriceCalc_v1.2.0.exe.7z. - Choose 7-Zip → Extract Here.
- Wait a few seconds —
PriceCalc_v1.2.0.exewill appear in the same folder.
Option B — 7-Zip not installed
If you do not see the "7-Zip" entry when right-clicking the .7z file, install 7-Zip first. It is free and safe and takes about 2–3 minutes.
- Open your browser and go to https://www.7-zip.org.
- Find the download table at the top of the page. Click the .exe link in the Windows x64 row.
- Double-click the downloaded installer (e.g.
2407-x64.exe), click Install, wait a few seconds, click Close. - Right-click
PriceCalc_v1.2.0.exe.7zand choose 7-Zip → Extract Here. PriceCalc_v1.2.0.exewill appear in the same folder — the program is ready.
2.2 Launching the program
Locate the extracted file PriceCalc_v1.2.0.exe and double-click it.
Windows security warning
A prompt may appear: "The publisher could not be verified" or "Windows protected your PC". This is normal — the program is safe.
- Click Run.
- If you see a blue SmartScreen window, click "More info", then "Run anyway".
2.3 Licence activation (first launch only)
On first launch, a licence activation dialog appears instead of the main window:
- A message is shown: "Licence not found. Please enter your licence key."
- Enter the licence key you received by email (format:
XXXXX-XXXXX-XXXXX-XXXXX). - Click "Activate".
- PriceCalc connects to the licence server and verifies the key.
- If the key is valid, the main program window opens.
2.4 Working offline
PriceCalc briefly connects to the internet every 3 days to verify that the licence is still valid. The program can work without an internet connection for up to 14 days from the last successful online check. A warning is shown as the offline limit approaches. After 14 days the program will stop working until internet access is restored.
3Main window overview
The PriceCalc window is divided into eight tabs along the top. Each tab handles a specific area of work.
| Tab | Purpose |
|---|---|
| Calculator | Main calculation screen — ingredients, labour, markup, VAT, final price |
| Ingredients | Ingredient management — add, edit, track stock, view purchase history |
| Recipes | Saved recipes — ingredient combinations for repeated use |
| Labour types | Define labour categories and hourly rates |
| History | Full calculation history (last 1000 calculations) |
| Settings | Default values, updates, licence, administrator PIN |
| About | Program version information and link to the online user manual |
| Contact | Supplier email, phone, website and address |
4Ingredient management (Ingredients tab)
Before calculating product prices you need to add ingredient names and record their purchase prices (receipting into the virtual stock). All ingredient management is done in the Ingredients tab.
4.1 Adding a new ingredient
- Click the "+ New ingredient" button in the top-right corner.
- Fill in the fields: name (required); unit of measure (e.g. kg, g, ml, pcs); notes (optional — useful for recording purchase invoice numbers).
- Click "Save".
The new ingredient appears in the list. The Cost/unit column shows "—" until the first purchase with a price is entered.
4.2 Recording a purchase
Each time you buy raw materials, record the purchase in PriceCalc so the system can track your real stock levels and calculate the correct weighted (FIFO) cost.
- Select an ingredient from the list by clicking it once.
- Click "New purchase".
- Enter the purchase details: quantity, unit price (excl. VAT), supplier, date and notes (e.g. invoice number).
- Click "Save".
4.3 The Cost/unit column
The "Cost/unit" column shows the weighted average cost, calculated from the current stock balance price and the unit price of any additional purchase. This is the value PriceCalc uses when calculating product costs. It is recalculated automatically after every new purchase is recorded.
4.4 Stock level colours
4.5 Purchase history
To view all purchase quantities, prices and balances by date, select an ingredient from the list and click "Purchase history".
4.6 Editing an ingredient
Double-click any row, or select it and click "✏ Edit". You can change the name, unit of measure and notes.
4.7 Removing an ingredient
Select an ingredient and click "Remove". The ingredient becomes hidden in the list, but its purchase history and calculation records are preserved.
5Calculating a product price (Calculator tab)
The Calculator tab is the main working area in PriceCalc. This is where you compose the ingredient list and receive the full price breakdown.
5.1 Step-by-step guide
Step 1 — Enter ingredients
In the "Ingredients (raw materials)" section:
- Click the ingredient name field and start typing the raw material name. After one or two characters a dropdown list appears with the closest matches.
- Click the required ingredient from the list and press Enter.
- Enter the quantity in the "Quantity" field. The unit of measure (g, ml, etc.) is shown automatically.
- To add more ingredients, click "+ Add ingredient".
- To remove an ingredient, click the red "X" button at the end of its row.
Step 2 — Additional components (optional)
In the "Additional components" section: enter packaging, labels or other additional costs as a single total amount (EUR, excl. VAT).
Step 3 — Labour cost (optional)
In the "Labour cost" section:
- Select a labour type from the "Labour type" dropdown (labour types are defined in the Labour types tab).
- Enter the labour coefficient. The coefficient represents time:
Step 4 — Markup and VAT
In the "Markup and VAT" section:
- Markup, % — enter the desired markup percentage (e.g. "30" means 30%)
- VAT, % — enter the VAT rate (e.g. "21" means 21%)
Step 5 — Calculate
Click the green "CALCULATE" button. All price calculation components are shown immediately in the right-hand panel.
5.2 Reading the result
The result panel on the right shows:
- INGREDIENTS — each ingredient with quantity, cost/unit and line total. Symbols: ✓ = OK, ⚠ = stock exists but insufficient, ✗ = no stock at all, ? = no unit price entered.
- Total raw material cost — sum of all ingredient lines plus additional components (if any).
- LABOUR COST — labour cost calculation, if a labour type was selected.
- SELLING PRICE — final calculation: cost, markup amount, price excl. VAT, VAT amount, and final selling price incl. VAT.
After each calculation, stock levels in the Ingredients tab are automatically reduced — consumed quantities are deducted from the oldest purchase lots first (FIFO method).
5.3 Stock blocking
If the quantity of any ingredient exceeds the actual stock balance, the calculation is blocked and an error message is shown. You must either:
- Reduce the quantity in the calculator, or
- Replenish stock in the Ingredients tab (record a new purchase), then recalculate.
5.4 Export and clear
- "PDF" button — saves the full price calculation to a PDF file.
- "Excel" button — saves the calculation to an Excel (.xlsx) file.
- "Clear" button (red) — clears the calculation result panel and resets the calculator to its initial state.
6Recipes (Recipes tab)
If you regularly calculate products with the same composition, save the ingredient combinations as production recipes. All ingredients can then be loaded with a single click instead of being re-entered each time.
6.1 Saving a recipe
- In the Calculator tab, enter the ingredients as required.
- Click the "Save recipe" button at the top of the calculator.
- Enter a name for the recipe and click "OK".
The recipe is saved with all ingredients, quantities, markup and VAT.
6.2 Loading a recipe
Method A — from the Calculator tab: select a recipe name from the dropdown at the top, then click "Load".
Method B — from the Recipes tab: select a recipe from the list, then click "Load into calculator".
6.3 Deleting a recipe
In the Recipes tab, select a recipe and click "Remove recipe". The recipe is deleted, but the calculation history is preserved.
7Labour types (Labour types tab)
Labour types define the different work categories used in your production, each with its own rate per coefficient unit.
7.1 Adding a labour type
- Click "+ New labour type".
- Enter a name, rate (EUR/unit) and an optional description.
- Click "Save".
The rate represents the cost per one coefficient unit. For example:
| Rate | Coefficient | Labour cost | Time |
|---|---|---|---|
| 20.00 | 0.50 | 10.00 EUR | 30 minutes |
| 20.00 | 1.00 | 20.00 EUR | 1 hour |
7.2 Editing and deleting
Select a labour type from the list and click "✏ Edit" to modify it, or "🗑 Remove" to delete it.
8Calculation history (History tab)
Every completed calculation is automatically saved to the history. The most recent 1000 calculations are shown with key indicators: date, recipe name, raw material cost, total cost, price excl./incl. VAT, markup percentage and VAT percentage. The history can also be filtered by date range and recipe name.
9Settings (Settings tab)
9.1 Default values
Set the default markup and VAT percentages that will be pre-filled in every new calculation. You can always change them in the calculator.
9.2 Automatic updates
If your supplier has provided an update URL, enable "Automatically check for updates". PriceCalc will notify you when a new version is available.
9.3 Licence
The licence section shows the current licence status and expiry date. You can also:
- Change / activate key — enter a new licence key if the current one has expired or you received a replacement.
- Deactivate — remove the licence from this computer before transferring to a new one. Requires the administrator PIN.
9.4 Administrator PIN
The "Deactivate" button requires a PIN code (default: 1234). This PIN can only be changed by an administrator — at the bottom of the Settings tab in the "Administrator PIN" section. As a regular user, you do not need to know the PIN — contact your supplier for licence transfers.
10About & Contact
About
The About tab shows the version of PriceCalc installed on your computer and a clickable link to the online user manual. Click "Open" next to the URL to open the manual in your browser.
Contact
The Contact tab shows your software supplier's contact information: company name, email, phone number, website, address and working hours. Click "Send email" to open a new message addressed to the supplier directly from your email application.
11Data backup
PriceCalc stores all your data — ingredients, purchase history, recipes, labour types, settings and calculation history — in a single database file on your computer. If your computer fails, is lost, or Windows is reinstalled, all data will be lost unless you have a backup.
11.1 Where the database file is
The database file is named pricecalc.db and is located in the PriceCalc program folder, for example:
pricecalc.db.11.2 Backing up to a USB drive
- Close PriceCalc before making a backup.
- Insert a USB drive into the computer.
- Open File Explorer (Windows key + E).
- Navigate to the PriceCalc program folder.
- Find
pricecalc.db, right-click and choose Copy. - Open the USB drive in File Explorer.
- Create a folder called
PriceCalc_backup(right-click → New → Folder). - Paste the file into that folder (right-click → Paste).
- Safely eject the USB drive.
11.3 Restoring from a backup
- Close PriceCalc.
- Insert the USB drive containing the backup.
- Copy
pricecalc.dbfrom the USB drive. - Navigate to the PriceCalc program folder on your computer.
- Paste the file, replacing the existing
pricecalc.db. - Launch PriceCalc — all your data will be restored.
11.4 File naming tips
To keep multiple dated copies, rename the file before copying, for example:
pricecalc_backup_2026-04-28.db pricecalc_backup_2026-05-05.dbThis allows you to return to an earlier version if needed.
12Troubleshooting
| Problem | Solution |
|---|---|
| PriceCalc.bat opens and closes immediately | Use the .exe file compiled with Nuitka — Python is not required on the client machine. |
| Error "No module named reportlab" | Open cmd and run: pip install reportlab openpyxl requests |
| Activation: "Key not found" | Check that the key was entered correctly. Contact your supplier if the problem persists. |
| Activation: "Already in use on another computer" | You are on a different computer. Contact your supplier for a licence transfer. |
| Activation: "Licence has expired" | The subscription has ended. Contact your supplier for renewal. |
| "Could not connect to server" | Check your internet connection. The program works for up to 14 days without a connection. |
| Ingredient cost shows "—" | No purchases recorded. Add a purchase in the Ingredients tab. |
| Calculation blocked — stock error | The quantity exceeds the stock balance. Reduce the quantity or replenish stock. |
| PDF and Excel buttons are greyed out | Complete a calculation first — export is only available after calculating. |
| Dropdown list does not appear | Type at least 1 character. Check that the ingredient exists in the Ingredients tab. |