Welcome to MonTally

MonTally is a desktop companion for Pokémon encounter tracking. It is designed to help hunters keep a clean, customizable, and persistent record of encounters while staying lightweight enough to run during long sessions.

MonTally currently supports two main workflows:

• Standard capture detection for the classic MonTally OCR-based tracking flow
• Native PokeMMO integration for real-time sync and importing current tracker data

This documentation is meant to be practical. It explains what MonTally does, how to set it up correctly, and how to get the most reliable results across Windows, Linux, and macOS.

What MonTally Can Do

MonTally is more than a simple counter. Depending on how you use it, it can:

• Track encounters continuously in a small always-on-top desktop UI
• Store encounter data across sessions
• Separate progress with profiles
• Auto-switch to a game profile when a supported game is detected
• Sync encounter data directly from PokeMMO
• Mirror PokeMMO encounter data in real time
• Let you fully customize colors, sprites, and counter visuals
• Import and export settings and encounter data
• Work with multi-monitor capture setups

Recommended Reading Order

If you are new to MonTally, this order will give you the fastest smooth setup:

1. Tracking Guide
2. Profiles
3. PokeMMO Integration
4. Themes
5. Data Management
6. Troubleshooting

Quick Start

1. Install MonTally

• Download the correct build for your operating system from the download page
• Install or unpack the application depending on platform
• Launch MonTally

2. Choose Your Workflow

You can use MonTally in two different ways:

• Standard tracking Best when you want the classic capture-area based experience
• PokeMMO-connected tracking Best when you want direct live sync with PokeMMO

If you mainly play PokeMMO, use a dedicated PokeMMO profile so MonTally can use the native tracker flow.

3. Configure Detection

For the standard workflow:

• Open Settings
• Go to Encounter settings
• Use Select Capture Area
• Save an area that includes the encounter names you want MonTally to read

For PokeMMO:

• Open Settings
• Switch to a PokeMMO profile
• Use Connect PokeMMO
• Enter the game and load your character
• If you already have tracker data in PokeMMO, use Sync with PokeMMO

If MonTally cannot use PokeMMO's bundled Java runtime on your system, install Java 21 SDK first:

• Oracle JDK 21 downloads: https://www.oracle.com/java/technologies/downloads/#java21

4. Adjust the Interface

MonTally lets you shape the UI to your workflow:

• sort order
• shiny percentage display
• total encounter display
• compact UI
• streamer mode
• sprite style
• colors
• custom counter frame and main art

You can do quick toggles in Settings and deeper visual work in Customize UI.

Core Concepts

Profiles

Profiles let you keep separate data sets and behavior presets. This is one of the biggest upgrades in modern MonTally.

Use profiles when you want to:

• keep one setup for general OCR-based hunting
• keep a different setup for PokeMMO
• separate encounter histories by game or playstyle

There is always a Default profile, and supported games can also have system game profiles.

Read more in Profiles.

Tracking Modes

MonTally uses different detection logic depending on the active profile:

• OCR detection Reads from the selected capture area
• Native tracker mode Used by supported game integrations such as PokeMMO

That means not every profile behaves the same way, and that is intentional.

Read more in Tracking Guide.

Native PokeMMO Integration

The PokeMMO integration is not just a skin on top of normal detection. It can:

• launch PokeMMO through MonTally
• attach the tracker connector
• read current encounter tracker state
• sync into a profile
• optionally keep Montally fully matched to PokeMMO in real time

Read more in PokeMMO Integration.

Themes and UI Customization

MonTally lets you customize both function and appearance:

• theme colors
• list sorting
• border and shiny color behavior
• compact mode
• sprite style
• custom counter images

If you want full control over the look, start with Themes and Theme Editor.

Supported Platforms

MonTally now has cross-platform support:

• Windows
• Linux
• macOS

Platform-specific behavior still matters in a few areas:

• Windows may show SmartScreen warnings because the app is unsigned
• macOS may require Gatekeeper bypass steps for unsigned builds
• Linux users may need to grant execute permission to the AppImage

See Troubleshooting for the platform-specific steps.

Multi-Monitor Support

MonTally can work in multi-monitor setups.

Important rule:

• your capture area must be configured on the same monitor where the game is currently displayed

If you move the game to a different monitor later, re-open Select Capture Area and save the area again so MonTally updates the selected monitor index.

Best Practices

If you want the most stable experience:

1. Keep your game window layout consistent while hunting
2. Reconfigure the capture area after moving the game to another monitor
3. Use a dedicated profile for PokeMMO if you rely on the native integration
4. Export your settings and encounter data regularly
5. Keep MonTally updated, especially after major feature releases

Documentation Map

Getting Help

If you run into a problem that is not covered here:

• Join the Discord community
• Check the GitHub repository
• Open a GitHub issue with clear reproduction steps

When asking for support, include:

• your MonTally version
• your operating system
• the game you are using
• whether you are using standard capture mode or PokeMMO integration
• whether the issue happens on one monitor or multiple monitors