Documentation

PisoTrack is a management platform for PisoNet (internet café) owners. It consists of two parts:

1. Dashboard (web) — your control center at pisotrack.com. Manage branches, PCs, view analytics, and send remote commands.
2. Agent (Windows app) — a lightweight app installed on each PisoNet PC. It reports status, receives commands, and enforces rules.

Create Your Account

1. Go to https://pisotrack.com/register
2. Enter your name, email, and password
3. Click Create Account
4. You're redirected to the dashboard — your account is ready

Create Your First Branch

1. In the dashboard, click Branches in the sidebar
2. Click + Add Branch
3. Enter the branch name (e.g. "Main Branch"), address, and rate (minutes per ₱1)
4. Click Save

Add PCs to Your Branch

1. Go to the PCs page in the sidebar
2. Click + Add PC
3. Select your branch and enter a PC number (1, 2, 3, etc.)
4. Click Save — an Agent Key is generated automatically
5. Copy this Agent Key — you'll need it when installing the agent

System Requirements

Before downloading, make sure your PisoNet PCs meet these requirements:

Windows Version Compatibility

Choosing 64-bit vs 32-bit

• 64-bit (x64) — Recommended for most PCs. Use this if your PC runs 64-bit Windows (check: Settings → System → About → System type).
• 32-bit (x86) — For older PCs running 32-bit Windows. This installer also works on 64-bit PCs, but the 64-bit version is preferred for better performance.

Download the Installer

1. Go to pisotrack.com/products/agent
2. Click Download 64-bit (recommended) or Download 32-bit for older PCs
3. Save the file to the PisoNet PC

Run the Setup Wizard

1. Right-click the installer and select Run as Administrator
2. Accept the license agreement
3. Choose install location (default: C:\PisoTrack Agent\)
4. Select whether to create a desktop shortcut
5. Click Install — takes about 30 seconds
6. Click Finish to launch the agent

First-Time Configuration

1. When the agent launches, it opens a configuration window
2. Enter the API URL: https://pisotrack.com
3. Paste the Agent Key you copied from the dashboard
4. Click Connect
5. If successful, the agent minimizes to the system tray and shows Online

Auto-Updates

The agent can update itself: it reports its version on every heartbeat, and the server replies with the version it should be running. If that is newer, the agent downloads the matching installer for its architecture, runs it silently and restarts.

The agent stores its configuration in appsettings.json in the install directory.

Configuration File

{
  "PisoTrack": {
    "ApiUrl": "https://pisotrack.com",
    "AgentKey": "your-unique-agent-key-here",
    "HeartbeatIntervalSeconds": 30
  }
}

Settings Explained

• ApiUrl — The PisoTrack server URL. Default: https://pisotrack.com
• AgentKey — The unique key from your dashboard. Do not share this.
• HeartbeatIntervalSeconds — How often the agent reports status (default: 30s). Commands are polled every 3 seconds regardless.

Agent Tray Icon

The agent runs as a system tray application (bottom-right of the taskbar). The tray icon shows:

• Green dot — Connected and online
• Yellow dot — In use (active session)
• Red dot — Disconnected or error

Right-click the tray icon for options: Open, Disconnect, or Exit.

The dashboard at pisotrack.com/dashboard is your central control panel. Here's what each page does:

Dashboard (Home)

Shows a summary of your business: total revenue today, active sessions, online PCs, and recent activity.

Branches

Manage your PisoNet locations. Each branch card shows the name, address, PC count, and online/in-use status. Expand settings to configure Blocked Apps and Operating Hours.

PCs

View all PCs across all branches. Each PC card shows real-time status (online/in-use/offline), session duration, and revenue. Includes buttons for Remote Control, Screenshot History, and Live View.

Sessions

Full log of all sessions — start time, end time, duration, and revenue. Filter by branch, date, or PC.

Analytics

Charts and trends: daily/weekly/monthly revenue, peak hours, busiest branches, average session length.

Add a Branch

1. Go to Branches → click + Add Branch
2. Enter branch name, address (optional), and rate (minutes per ₱1)
3. Click Save

Edit or Delete a Branch

Click the ✏️ (edit) icon to rename or change rate. Click the 🗑️ (delete) icon to remove a branch.

Rate Configuration

The rate is expressed as minutes per ₱1. For example:

• 4 minutes per ₱1 = ₱0.25/minute = ₱15/hour
• 5 minutes per ₱1 = ₱0.20/minute = ₱12/hour

Add a PC

1. Go to PCs → click + Add PC
2. Select the branch and enter a PC number
3. Click Save — an agent key is generated
4. Copy the agent key and use it when setting up the agent on that PC

PC Status Colors

• 🟢 Online — PC is on and agent is connected, but no active session
• 🟡 In Use — PC has an active paying session
• 🔴 Offline — PC is turned off or agent is not running

Agent Key Security

Each agent key is unique and tied to a specific PC. The first time a PC connects, its hardware ID is recorded. If someone tries to use the same key on a different machine, it will be rejected. This prevents unauthorized use.

Send commands to any online PC directly from the dashboard.

Available Commands

• 🔄 Restart — Restarts the PC (graceful shutdown + reboot)
• ⏻ Shutdown — Shuts down the PC completely
• 👤 Log Off — Logs out the current Windows user
• 💬 Message — Displays a popup message on the PC screen
• 📸 Screenshot — Captures a screenshot of the current screen

How to Send a Command

1. Go to the PCs page
2. Find the PC you want to control
3. Click the corresponding button (Restart, Shutdown, etc.)
4. Confirm the action when prompted
5. The command is sent and typically executed within 3–5 seconds

Live View

Live View lets you see a PC's screen in near-real-time from your dashboard — like a remote desktop viewer.

1. Go to the PCs page
2. Click the 👁️ Live button on any online PC
3. The agent starts capturing screenshots every 1.5 seconds and uploading them
4. The dashboard auto-refreshes the image to simulate a live feed
5. Click Stop Live View to end the stream

Screenshot History

View past screenshots captured from a PC:

1. Click the 📷 History button on any PC card
2. A gallery opens showing timestamped thumbnails
3. Click any thumbnail to view full-size
4. Use Capture New to take a fresh screenshot on demand

Block specific applications from running on all PCs in a branch. When an app is blocked, users cannot open it at all — the app simply won't launch.

How It Works

PisoTrack uses Windows IFEO (Image File Execution Options) — a registry-level block that prevents the executable from launching entirely. This is not a "kill after launch" approach; the app genuinely cannot start.

Adding Blocked Apps

1. Go to the Branches page
2. Click 🛡 Blocked Apps on the branch you want to configure
3. Type the process name in the input field (e.g. chrome.exe, utorrent.exe, winword.exe)
4. Click Add (or press Enter)
5. Add as many apps as needed
6. Click 💾 Save & Push — this saves the rule and pushes a block command to all PCs in the branch

Removing a Block

1. Click the ✕ next to the app name to remove it from the list
2. Click 💾 Save & Push
3. The agent removes the IFEO block, and the app can be opened again

Finding Process Names

Not sure what process name to use? Open Task Manager → Details tab → look for the app in the Name column. That's the process name (e.g. WINWORD.EXE for Microsoft Word).

Set operating hours for each branch to control when PCs should be available.

Setting Hours

1. Go to the Branches page
2. Click 🕐 Operating Hours
3. Set Open Time (e.g. 08:00) and Close Time (e.g. 22:00)
4. Toggle Auto-shutdown if you want PCs to automatically shut down at closing time
5. Click 💾 Save

How Sessions Work

The agent automatically detects when a user logs in or starts using the PC. A session begins when activity is detected and ends when the user stops.

• Session duration is tracked in real-time
• Revenue = duration × rate per minute
• All sessions are logged with start time, end time, duration, and earnings

Viewing Sessions

Go to the Sessions page to see a log of all sessions. You can filter by branch, PC, or date range.

Analytics

The Analytics page shows trends, charts, and summaries — daily earnings, peak hours, branch comparisons, and more.

Agent shows "Disconnected"

• Check that the PC has an internet connection
• Verify the API URL is correct: https://pisotrack.com
• Ensure the agent key matches the one in the dashboard
• Try restarting the agent

PC shows "Offline" in dashboard

• Check if PisoTrackAgent is running (check system tray or Task Manager)
• If not running, launch it from Start Menu or Desktop
• If it crashes on start, check appsettings.json for valid configuration

Agent key rejected

• Each agent key is bound to one PC. If you reinstall Windows, the hardware ID changes
• Solution: Delete the PC from the dashboard and re-add it to get a fresh key

Blocked app still opens

• Make sure you clicked Save & Push (not just Add)
• Wait 3–5 seconds for the agent to pick up the command
• Verify the agent is running and connected (green tray icon)
• The agent must be running as Administrator for IFEO to work

Screenshots not loading

• Ensure the agent is connected (not offline)
• Click Capture New to request a fresh screenshot
• If no screenshots appear, the upload may have timed out — check PC's internet speed

Need more help?

Contact us at [email protected]

Besides the Agent, PisoTrack ships seven standalone Windows applications. They do not install with the Agent and they do not run as background services — each is an app you open on the PC when you need it.

Installing any suite app

1. Open the product page (linked in each section below) and download the installer.
2. Run the installer on the client PC. Windows SmartScreen may warn you the publisher is unrecognised — choose More info → Run anyway.
3. Launch the app. On first run it asks for your PisoTrack licence key.
4. Paste the key from Dashboard → Billing. The key binds to that PC's hardware.

Using suite apps with FrostGuard

If FrostGuard is freezing the system drive, anything a suite app writes to C: is discarded on reboot — including its own licence activation. Unlock FrostGuard before installing or configuring any suite app, then re-lock when you are done.

Reduces background load on low-spec PCs so games get more RAM and CPU. It is an analyse-then-apply tool you run on the PC — it does not tune anything silently in the background, and there is no dashboard switch for it.

Product page & download →

How to use it

1. Open the Optimizer and click Analyze PC. Nothing is changed yet — it reports what it found.
2. Review Analysis Results. Items are grouped by module: bloatware, services, telemetry, visual effects, power plan, network, virtual memory and Windows 11 tweaks.
3. Untick anything you want to keep, then click Apply Protection.
4. A system restore point is created before changes are written.

Aggressive Mode

Applies the same modules with wider limits — more services stopped, more telemetry disabled. Useful on 4GB machines that only ever run games. Check the results list before applying it on a PC that also handles printing, scanners or POS hardware, because those depend on services Aggressive Mode may stop.

Undoing changes

• Activity Log shows everything applied, with timestamps.
• Use the system restore point created before the run to roll back completely.
• Clear History only clears the log — it does not revert anything.

Freezes the system drive using the Windows Unified Write Filter (UWF). While protection is on, every write to C: goes to an overlay held in RAM or on disk, and the overlay is discarded on reboot — so the PC returns to a known-good state.

Product page & download →

Before you enable it

1. Get the PC into the exact state you want it to return to: Windows updated, games installed, Agent installed and connected, licences activated.
2. Decide what must survive reboots — customer saves, game updates, logs — and keep it on a separate drive or add it as an exclusion.
3. Set an admin password in FrostGuard. You need it to unlock later.
4. Enable protection and restart. UWF only takes effect after a restart.

Making changes to a frozen PC

Unlocking is done in the FrostGuard app on that PC, with the admin password — there is no remote thaw from the cloud dashboard. The sequence is always the same:

1. Open FrostGuard, unlock with the admin password, turn protection off.
2. Restart. The drive is not actually writable until you do.
3. Make your changes.
4. Turn protection back on and restart again.

Exclusions

An exclusion is a path that stays writable while everything else is frozen. Use them for save-game folders, launcher caches and app data you want to persist. File exclusions can be managed remotely from Dashboard → PCs; the commands queue and apply when the PC next comes online.

Overlay size

The overlay holds every write made since the last reboot. When it fills, Windows warns and can force a restart. FrostGuard sizes it from free disk space by default. On a PC where customers download a lot in one sitting, raise it — and remember a RAM-backed overlay consumes memory the games would otherwise use.

A full-screen shell that replaces the Windows desktop for customers. They see your game tiles and nothing else — no File Explorer, no settings, no installed-program list.

Product page & download →

Adding games

1. Open the launcher and sign in to the admin panel (Admin Login).
2. Choose Add New App and point it at the game executable.
3. Set the display name, artwork and category. Categories drive the top-level tabs customers see.
4. Save. The tile appears immediately — no restart needed.

Branding

The CMS panel controls the visual theme — colours, background, logo — and lets you publish an on-screen notice to every customer, which is useful for closing times or promotions. Changes apply to that PC; repeat on each machine, or clone the drive once the launcher is configured.

Admin access

The launcher can also open the other suite apps — FrostGuard, Optimizer and Download Manager — from inside the shell, so staff do not have to exit to reach them.

A front end for Windows and Office volume activation, aimed at shops deploying many identical machines. It includes KMS host setup and a KMS renewal scheduled task.

Product page & download →

Setup and licensing

Install and activate it like any other suite app — see Suite Apps: Common Setupabove. The Activation Output Console records what each operation did, and Copy All Output puts the log on the clipboard if you need to send it to support.

For help with your PisoTrack licence for this app (not with Windows licensing), contact [email protected].

Scans the machine for hardware with missing or outdated drivers, finds the right package, and installs it. Built for setting up mixed second-hand fleets where no two motherboards match.

Product page & download →

How a run works

1. Scan — it compiles a hardware report: display, audio, network, Bluetooth, storage, cameras, biometrics, COM/LPT and more.
2. Match — each device is resolved against NVIDIA, Intel, AMD, Realtek and Microsoft Update sources.
3. Download — packages are fetched in parallel byte ranges, and pulled from other PisoTrack PCs on your LAN when one already has the file.
4. Install — drivers are extracted and installed, with a backup taken first.

LAN sharing

On a fleet, the first PC downloads a driver package from the internet and the rest pull it from that PC over the local network. Setting up ten identical machines costs roughly one machine's worth of bandwidth. Keep the PCs on the same subnet for this to work.

Backups and recovery

• The Backups view holds the previous driver for anything replaced — use it if a new driver misbehaves.
• Drivers can also be injected into the Windows Recovery image, so a PC that fails to boot still has working storage and network drivers in WinRE.

A download manager built for shop connections: it splits each file into segments downloaded in parallel, resumes after a dropout, and can be speed-limited so a large game patch does not starve the customers who are playing.

Product page & download →

Adding downloads

• Add URL for a single file.
• Add batch download from clipboard — copy a list of links and it queues all of them at once.
• Downloads are filed into categories (archives, documents and so on); you can add your own.

Managing the queue

• Apply a speed limit while the shop is busy and remove it after closing.
• Interrupted downloads resume rather than restarting, provided the server supports it.
• Export download list saves the queue so you can reuse it when setting up the next PC.
• Clear Done and Delete All Completed tidy the list without touching the files.

Installs the redistributables games depend on — DirectX, the Visual C++ runtimes and .NET — and repairs them when they go missing. This is the tool for "MSVCP140.dll was not found" and "d3dx9_43.dll is missing".

Product page & download →

How to use it

1. Open the app. It detects what is already present and marks each entry Installed or Not Installed.
2. Click Install All, or install individual items.
3. Everything runs silently — no per-package wizards to click through.
4. Restart the PC once the run finishes so games pick up the new runtimes.

Offline installs

The installer can work from a local package source instead of downloading, which is what you want when setting up several PCs or when the connection is poor. If you see Offline Source Missing, the package folder is absent — either restore it or let the app download instead. Some components install through DISM from the Windows image and are shown as Ready via DISM.

If something fails

• Save Console Logs writes the full output to a file — attach it to any support request.
• A failure on one component does not stop the rest of the run.
• Run this before enabling FrostGuard; runtimes install into Windows itself and will not survive a frozen drive.