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/download
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

Once installed, the agent updates itself automatically. Every 5 minutes, it checks the server for a new version. If an update is available, it downloads the correct installer for your architecture (64-bit or 32-bit), runs it silently in the background, and restarts — no manual action needed.

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]