MantPro instructions
MantPro keeps track of maintenance in your plant or workshop: jobs done, jobs still to do, recurring maintenance, machines and warehouse stock. Technicians work from their phones, even offline, and everything reaches this PC when they sync.
Pick a topic in the index on the left or search for a word at the top. You can also open this window with the F1 key, straight at the topic for the tab you are on.
🚀 Getting started
- Sign in with your username and password. The first time there is a user
admin with password admin, and the program makes you change it.
- Create the technicians' users in Tools → 👥 User management.
- Add your machines in the 🏭 Machines tab. If you already have them in a spreadsheet, import them with File → 📥 Import from Excel/CSV…
- Link the phones with Tools → 📲 Sync App (QR) (see «Phone apps»).
- Choose your country or region in Tools → 🌍 Country / Region (Holidays) so the calendar shows public holidays.
👤 Session, users and permissions
Everyone signs in with their own user, and every job is signed with whoever did it. A user can have one or more roles:
- Administrator: can do everything, including managing users, configuring the warehouse and editing or deleting any record. It is the only role that sees prices, costs and everything about purchasing (suppliers and orders).
- Technician: logs jobs and completes pending jobs and alerts. Can only edit or delete their own records.
- Warehouse: manages items and stock movements from the MantPro Stock app.
In the Session menu you can switch user or log out without closing the program. You change your password in Tools → 🔑 Change my password.
An administrator creates, edits, deactivates and deletes users in Tools → 👥 User management. Deleting a user closes their sessions and releases their assigned phone, but their name is kept in the jobs, warehouse movements and records they made. You cannot delete yourself or the last administrator.
📊 Dashboard
An overview at a glance: pending alerts, tasks to do, records this month and the reliability indicators for the whole plant (MTBF, mean time between failures, and MTTR, mean time to repair). Below you will find the machines with the most jobs, breakdowns per month and how jobs are split by type.
The Cost this month and Cost this year cards add up the spare parts and labour of the jobs, and below you will see the machines with the highest cost this year (each one including its sub-machines) and the maintenance cost per month for the last 12 months. If some spare part or job has no price or rate, the total falls short and is shown with “≥”. The breakdown by machine and item is in Machines → 💶 Costs. Costs are only visible to administrators.
The reliability indicators are calculated from jobs tagged as Breakdown and their downtime hours.
The 👥 Statistics by technician button shows, for the year you choose, each technician's jobs (in total and month by month), their breakdowns, preventive jobs and downtime hours, and how many pending jobs they have assigned right now. In Type you choose to see all jobs, only work orders and breakdowns, or only preventive maintenance. With 📄 Export PDF and 📊 Export Excel you save it exactly as you see it.
📅 Calendar
Shows the jobs and alerts for each day. Click a day to see its list and double-click a job to edit it. Go to Today brings you back to the current day.
Public holidays, holidays, bridge days and days off are shown in different colours. They are managed with the Manage Days button or in Tools → Manage Days / Holidays. Public holidays are downloaded automatically for the chosen country or region.
🔁 Alerts (recurring maintenance)
An alert is maintenance that repeats: for example, greasing a machine every month. You create it with a title, start date, frequency (daily, weekly, monthly, quarterly, half-yearly or yearly), margin days, technician and specialty.
- Pending (orange): it is due and within its margin days.
- Overdue (red): the margin has passed without doing it. The alert is not skipped: it stays there until it is done.
Marking it as done creates a record in the history, and the next date is counted from the day it was actually done. With the right mouse button you can assign or delete several alerts at once.
📟 By counter: an alert can follow a machine's hours of use, cycles or km instead of (or as well as) the date: «oil change every 500 h, warn 50 h before».
- The counter comes first: an alert can only use counters that already exist. Create them beforehand in Machines → 📟 Counters (administrators only). The alert's Counter drop-down lists those of all machines («Machine — Name (unit)»); if it is empty, there are none yet, and the form itself says so.
- Fields: tick By counter when creating or editing the alert, choose the counter and fill in Every (how often it is due, in the counter's unit: 500), Warn before (how far ahead it turns orange: 50) and, if you like, First time at (the reading at which it is due the first time; empty means «automatic»: the current reading plus «Every»). Numbers are typed as usual: «1.500» is 1500 and «6,5» is 6.5.
- Whichever comes first: with Also, at most with the date frequency the alert keeps its date frequency too (yearly, monthly…) and is due whichever comes first («every 500 h or every year», for a machine that is seldom used). Unticked, it goes by counter only: it is not shown in the calendar, but it does count in the Dashboard.
- Colours: normal until it enters the warning margin, orange within it and red when overdue. The column shows what is left («1500 h (now 1440 h)») and the tooltip says when it will be reached at the current rate of use.
- Estimated date: calculated from the average use over the last 180 days, since the last time the counter dropped (replaced or reset). It needs at least two readings one day or more apart and the counter must be going up; otherwise it cannot be estimated and is not shown.
- Completing it: the dialog asks for the reading at that moment (optional, next to the time worked). The next one is counted from it («every 500 h» from there), the job is linked to the machine and the reading goes into the counter's history. If it is lower than the previous one, you are asked to confirm (counter replaced or reset).
- Undoing: unticking the completion or deleting the job from the history goes back to the previous cycle; the reading stays in the counter's history but no longer counts as the start of the cycle.
- On the phone counter-based alerts appear the same way, also offline: the status (orange or red) takes into account readings entered on the phone that have not yet been sent to the PC.
- Changes to the alert (counter, «Every», «Warn before», «First time at») and the readings are recorded in the Change log.
📝 Logging a job
To record a job already done: date, a short summary, the details, the machine and the tags (Urgent, Electrical, Mechanical, Preventive, Breakdown or others you type).
- Photos: drag a before photo and an after photo onto their boxes, or click to browse. In the photo collection you can add as many as you like, and also videos (up to 100 MB; recorded with the phone): they show a play icon and double-clicking opens them with the computer's video player. The before and after photos are always photos.
- If it is a breakdown, enter the downtime hours: they are used for the MTTR.
Press 💾 SAVE RECORD to save it to the history.
🔩 Materials used: note the warehouse items you used (the selected machine's parts are listed first). They are taken out of stock and saved with the job and their price. Also when completing a pending job and, to correct them, when editing the job in the history: the stock is adjusted automatically. The cost per machine is in Machines → 💶 Spare parts cost; each item's price is in its record, and the currency in Warehouse stock → ⚙️ Configure warehouse. The cost is only visible to administrators.
⏱️ Time worked: how long the job took (1:30, 1.5 or 90 min) and how many people. It is noted afterwards, once you are back: there is no stopwatch. Also when completing a pending job or a reminder and, if forgotten, when editing the job in the history. It is used for the labour cost and for each technician's hours in the statistics. It is optional: if it was only a check, leave it empty.
📋 History
All the jobs done, organised by years and months. You can filter by technician and by type (jobs and breakdowns, or preventive alerts).
- Double-click a job to view or edit it, with its photos.
- With the right mouse button you can delete several jobs, revert to pending a job finished by mistake and, if you are an administrator, change the author of several records at once.
Every change is logged in Tools → 📋 Change log: who made it, when, from where (PC or phone) and which fields changed.
🔍 Search
Find jobs by text (for example «motor», «leak» or the name of a part), by date range and by tags. Results open with a double-click, just like in the history.
🔨 Pending
Jobs still to do. Each pending job has a title, details, priority (Low, Medium, High or Critical, each with its colour), specialty, photos and the technician it is assigned to.
- ✅ Complete moves it to the history; you can then add the final photos and details.
- 👤 Reassign changes the technician. The Show those of list filters by person.
- On the phone, each technician sees their pending jobs with the «Only mine» filter.
🏭 Machines
A tree of machines and sub-machines (for example, a line with its equipment). Expanding a machine shows its jobs by years and months, and double-clicking opens each job.
- Each machine can have a zone, notes and a photo, shown when you select it.
- Selecting it shows its reliability indicators (breakdowns, MTBF and MTTR).
- 🏷️ QR labels creates a PDF of labels (24 per A4 sheet, 70 × 37 mm) to stick on the machines. Scanning them with the MantPro app opens that machine's page.
- 🔩 Spare parts: below the tree you see the warehouse items fitted to the selected machine, how many it has, how many are in stock (in red if below the minimum) and where they are. Add them with ➕ Add spare part; double-click to go to the item in Stock. On the phone they appear in the machine's page, and in Warehouse stock each item shows which machines use it; you can also link it to its machines when creating or editing it.
- 💶 Costs: how much the maintenance of each machine has cost, including its sub-machines, by year: hours worked, labour (hours × cost per hour) and spare parts, with the detail of the selected machine's items. It can be exported to Excel. The cost per hour is set right there (administrators only); each job keeps the rate in force when its time was noted. The machine's spare parts are listed first when noting the parts used in a job, on the PC and on the phone. Administrators only.
- 📟 Counters: hours of use, cycles or km of the selected machine, for counter-based preventive tasks. With the machine selected, press 📟 Counters:
- ➕ New counter (administrators only): name («Hours of use»), unit («h») and, if you know it, the current reading. A machine can have several (hours and cycles, for example). ✏️ Edit changes the name and the unit.
- 🗑️ Delete removes the counter with all its readings. It cannot be done if an alert uses it: change or delete those alerts first. Deleting a machine deletes its counters, and the alerts that used them stop going by counter.
- 📟 Enter reading (anyone who can register jobs): notes the value and the date; it can also be done from the machine's page on the phone or when completing a counter-based preventive task.
- 📋 Readings shows the history; an administrator can delete a wrong one with 🗑️ Delete reading.
Each counter shows its last reading and the average use per day. The reading that counts is the most recent by date (not the highest), so a replaced or reset counter keeps working; if you enter one lower than the previous, you are asked to confirm.
📦 Warehouse stock
The warehouse is organised into zones → shelving units → shelves → sections (sections are optional). Only an administrator can change that structure, with ⚙️ Configure warehouse.
- ➕ Add material: code, name, description, unit, minimum stock, location, photo and unit price (administrators only).
- 📥 Stock in / 📤 Stock out: records stock movements with an optional reason. A manual stock out cannot leave the stock negative.
- To move items to another place, select them and use the right mouse button.
- When you select an item, its movement history appears below. 📜 History shows every movement in the warehouse in order.
- 📄 Export outputs the stock, all of it or one zone or shelving unit, to PDF, CSV or Excel.
- 💶 Prices: each item can have a unit price, used for the cost of the spare parts used in jobs. Only an administrator can set or change it (also from MantPro Stock). The currency is chosen in ⚙️ Configure warehouse. A job's cost is saved with the price at that moment: if the price changes later, what has already been done does not change. The price is only visible to administrators: everyone else sees it nowhere, neither on the PC nor in MantPro Stock.
- 📦 Daily check (MantPro Stock): every day the app suggests checking 5 random items and sends a notification. Count each one and correct the quantity if needed; the app records who did it and whether all 5 were checked (see Tools → 📦 Warehouse check history).
- 🏭 Suppliers: the Suppliers button opens the warehouse supplier list (name, contact person, phone, email and notes) so you can add, edit or delete them; only administrators can use it. In each item's form you choose its usual supplier. If you delete a supplier, its items are left without a usual supplier. Changes are recorded in the change log.
- 💶 Prices by supplier (administrators only): in an item's form, the Prices by supplier… button shows the latest price from each supplier (the cheapest in green, with how much it has gone up or down) and the full history. You can add a price by hand, delete an entry or use one as the item's price. When you record a stock entry you can say who it was bought from and at what price, and it goes into the history; if the price differs from the item's, you are asked whether to update it (it never changes by itself).
- 🎯 Target stock and order multiple: (administrators only) in an item's form you can say how much you want to have after ordering (target stock; if left empty, the minimum stock × the factor in ⚙️ Configure warehouse is used, 2 by default) and the order multiple if it is only bought in boxes or lots. Below you will see how much would be suggested to order with the current stock, rounded up to the multiple.
- 🛒 Orders (administrators only): in Low stock, the Suggested order… button lists what to order (target stock − what you have − what is already ordered and on its way), with supplier, estimated price and total; you can change quantities and suppliers and untick what you do not want (you can select several rows and tick or untick them at once, also with the space bar). Create orders saves one order per supplier, with its date. The 🛒 Orders button in the stock tab lists them: ✉️ Email opens your email with the text and leaves the PDF to attach, 💬 WhatsApp opens the chat with the text written (the supplier's phone must include the prefix, e.g. +34), 📞 Phone shows the phone and the text to read or copy, and 🖨️ Print / PDF creates the PDF. The text and the PDF carry no prices. Each stock entry deducts what is pending from the orders (oldest first): they become Partial and, when everything has arrived, Received. You can also mark an order as received (without changing the stock), cancel it or delete it.
Stock is shown in red when it is below the minimum and in green when it is above it.
⚠️ Low stock
Items out of stock or below their minimum (quantity in red) and those right at the minimum (quantity without colour), to keep an eye on them. The tab title counts only those below. From here you can go to the item, record a stock in or export the list to place the order; when exporting you choose whether to include those right at the minimum. If you are an administrator, the 🛒 Suggested order… button works out what to order (discounting what is already ordered) and creates the orders; see 🛒 Orders in “Warehouse stock”.
💾 File menu: backups, import and export
- 💾 Backup: a full copy (databases and photos) in a ZIP, wherever you choose. MantPro also makes automatic backups (see below).
- ♻️ Restore: recovers a manual backup or one of the automatic ones. It replaces all current data.
- 🛡️ Automatic backups…: MantPro backs up the databases and new photos on its own into the
backups_auto folder: always when closing, every 2 hours while it is open (if there have been changes), shortly after receiving data from a phone, and when opening if there were changes left uncopied. Here you choose how often and how many backups are kept (by default, the last 10 and one per day for the last 14 days) and, highly recommended, an external folder (NAS, USB drive or a Nextcloud/Dropbox/Google Drive folder) where every backup is also sent: a backup on the same disk is useless if the disk fails. After each backup, MantPro tests that it can be restored (without touching your data). At the bottom right, in the status bar, you can see the date of the last good backup; if something fails, «⚠️ Backups: check» appears in red. To restore from the external folder, use Restore → Restore from automatic backup and pick a backup from that folder.
- 🔒 Backup password…: encrypts backups (manual, automatic and the ones made beforehand) with a password, so they cannot be opened if they leave the computer (USB, NAS, cloud). On this computer they are restored without asking for it; on another one, it is asked for. If you forget it, encrypted backups cannot be recovered.
- 📥 Import from Excel/CSV…: brings in machines, items, alerts, users, pending jobs and old work history from a spreadsheet. You can download a template and check a row-by-row preview, and a backup is saved before importing.
- 📤 Export: the history to PDF (with your company logo, if you add it in PDF Options), CSV or Excel, with a filter by technician.
🛠️ Tools menu
- 📲 Sync App (QR): shows the code to link the phones.
- 📱 Install MantPro on phone and 📦 Install MantPro Stock on phone: show a QR code; scanning it with the phone's camera downloads the latest version of the app to install it.
- 🔌 Sync port…: change it only if another program uses the same port. The QR then has to be scanned again on the phones. MantPro uses that port and the next one (the latter for the encrypted connection): if there is a firewall, open both.
- 👥 User management, 🔐 Device sessions (which phones are connected right now, and revoking their access) and 📋 Change log (who changed what, when and from where: jobs, pending jobs, reminders, checklists, machines, warehouse, users, security, backups and settings, with each field before → after; it can be filtered, searched and exported to Excel or CSV).
- 📦 Warehouse check history (administrators only): who did the daily check of the 5 items suggested by MantPro Stock, whether they checked them all (✅ complete, ⚠️ incomplete, ❌ not checked), and the quantity counted compared with what the system said. Filter by user, period and status, and export to Excel or CSV. If any working day in the last 7 had no check at all, MantPro warns you when it opens and marks it in red; below you can see which phones have done checks (with whom and the date of the last one).
- 🔐 Database encryption…: stores
mantenimiento.db and almacen.db encrypted (SQLCipher), with the key in the system keyring: MantPro opens them by itself, but anyone who copies the files or takes the disk cannot read them. When it is turned on, a recovery key is shown that you must write down: MantPro asks for it if the keyring loses the key (system reinstalled, new user…). The change is made when MantPro is opened again.
- 📅 Manage Days / Holidays and 🌍 Country / Region (Holidays): special days in the calendar.
- ☑️ Checklists…: create templates of items to check (OK / not OK / N/A, or readings with their unit and correct range) and assign them to reminders and pending jobs when creating or editing them. When they are completed, on the PC or the phone, the checklist must be filled in; it is saved with the job (☑️ in the history, ☑️❌ if something was not OK; right-click to view it) and it appears in the PDF, Excel and CSV.
- 🗑️ Maximum job retention time…: deletes jobs older than the time you choose, after making a backup.
- 🧹 Clean Orphan Photos: deletes photos that no record uses any more.
- 🌐 Language and, in the Appearance menu, the light, dark or classic theme.
📱 Phone apps
There are two Android apps: MantPro (jobs) and MantPro Stock (warehouse).
- With the phone on the same WiFi network as the PC, open Tools → 📲 Sync App (QR).
- On the phone, tap Link PC and scan the code.
- Sign in with your username and password. You only need to do this the first time.
- The apps work offline: everything is stored on the phone and sent automatically when the PC is within reach again.
- While the app is open, even in the background, it keeps syncing and shows a «Connected to the PC» notification. Once fully closed it stops using battery.
- In MantPro, the scan button reads a machine's QR label and opens its page.
- The connection with the PC is encrypted. To pair a new phone, update its app first: an old app does not understand the new QR code.
- Reminders and pending jobs marked ☑️ have a checklist: it is filled in on the phone when completing them, also offline.
- A machine's page (opened by scanning its QR code) shows its 📟 counters with their last reading: tap Enter to note the reading, also offline (it shows at once and is sent to the PC when syncing; if the same upload is repeated, it is not duplicated). Its counter-based preventive tasks are listed too, with what is left and their status, and when completing one of them the reading can be entered in the same step.
- If the phone is assigned to a technician (see “Security and encryption”), the login screen already shows their user and says who it is assigned to; nobody else can log in, except an administrator.
- MantPro Stock is only for stock control: the price of items is only seen and changed by an administrator, and suppliers, prices by supplier and orders are managed only on the PC.
🛡️ Security and encryption
- Encrypted connection with the phones (HTTPS): the PC creates its own certificate and its fingerprint travels in the pairing QR code, so the phones only connect to that PC and nobody on the WiFi can read the data or impersonate it. The encrypted connection uses the port after the sync port (5001 if you use 5000): if there is a firewall, open both.
- Unencrypted connection: while there are phones with an old app, the PC also serves them unencrypted. In Tools → 🔐 Device sessions, the «Encryption» column shows which phones still use it; when none is left, press Turn off the unencrypted connection.
- Protected sign-in: after 5 wrong passwords in a row, the user is blocked for 15 minutes on the phone and for one minute on the PC. On the phone, the session is kept in Android's secure storage.
- Phone sessions: every time the phone connects to the PC its session is renewed, so there is no need to sign in again. If a phone goes 60 days without connecting (lost, or from someone who is no longer here), its session is closed automatically; the period can be changed in Tools → 🔐 Device sessions. Anything not yet sent is not lost.
- Phone assigned to a technician: in Tools → 🔐 Device sessions, select a session and press 📲 Assign phone to a technician…. From then on that phone only lets its technician sign in (administrators can always sign in) and the app pre-fills their username on the sign-in screen. It applies to MantPro and MantPro Stock at once (they share the phone's identifier), so the same technician can use both apps on the same phone. The phone must have connected with the updated apps; sessions already open are not closed. The “Phone of” column shows who it is assigned to and the change is recorded in the change log.
- Checked photos: the PC only saves photos from the phones if they are real images of 30 MB at most, and over the encrypted connection they can only be viewed while signed in.
- Encrypted databases (Tools → 🔐 Database encryption…, off by default): anyone who copies the files or takes the disk cannot read the data. MantPro opens them by itself with the key in the system keyring. Write down the recovery key shown when you turn it on and keep it outside the computer.
- Encrypted backups (File → 🔒 Backup password…): backups that leave the computer (USB, NAS, cloud) cannot be opened without the password. Backups contain the data without the database encryption, so they can be restored on another computer: protect them with this password.
- Photos are not encrypted. To protect the whole computer, also use disk encryption (BitLocker on Windows, LUKS on Linux).
❓ Common problems
- The phone does not connect: check that the PC and the phone are on the same WiFi and that MantPro is open on the PC. On Windows you may need to allow the program in the firewall. If the PC's IP address has changed, scan the QR again.
- «The port is in use»: usually another MantPro is open. Close it or change the port in Tools → 🔌 Sync port…
- Someone forgot their password: an administrator can reset it in Tools → 👥 User management.
- The daily notification does not reach the phone: on Xiaomi, OPPO/Realme or Huawei set the app to Battery → No restrictions.
- I made a mistake when restoring or importing: the
backups_auto folder holds the backups made beforehand.
- «⚠️ Backups: check» appears at the bottom right: the last automatic backup failed, could not be restored in the test or could not be sent to the external folder (USB drive unplugged, NAS switched off). Click it to see why, fix it and click 💾 Back up now.
- MantPro asks for a recovery key when opening: the databases are encrypted and the system keyring no longer has their key (system reinstalled, another user…). Enter the key you wrote down when you turned encryption on. If you do not have it, move
mantenimiento.db and almacen.db out of the data folder, open MantPro and restore a backup.
- «Too many failed attempts»: wait for the time shown in the message or ask an administrator to reset the password.
- Restoring asks for a password: the backup is encrypted with the backup password of the computer where it was made (or with an earlier one). It cannot be restored without it.
- “This phone is assigned to …”: the phone is reserved for a technician and only they (or an administrator) can log in. To release or change it, an administrator uses Tools → 🔐 Device sessions → 📲 Assign phone to a technician… and chooses another technician or “Nobody (free phone)”.
- I cannot see prices, costs, suppliers or orders: only administrators see them, on the PC and in the apps. Ask an administrator to check it.
- WhatsApp does not open the supplier's chat: their phone must include the international prefix (e.g.
+34 600 000 000). Fix it in 🏭 Suppliers; without a prefix, WhatsApp may not recognise it.
- An item does not appear in the suggested order: only items below their minimum that have a minimum stock or a target appear, and not if what is already ordered covers the shortfall. Items without a usual supplier appear without a supplier: choose one before creating the orders.
- I recorded a stock entry and the order did not go down: the entry only deducts the open orders of that item (not cancelled or already received ones), first those of the supplier indicated and then the oldest. Inventory adjustments do not deduct orders, and “mark as received” does not change the stock.