Skip to content

Starting the Application

This guide shows you how to start and access the MSM Data Collector interface.

Launching the Application

Step 1: Open a Terminal

Navigate to the application folder:

  1. Open File Explorer
  2. Navigate to your installation folder
  3. Type cmd in the address bar and press Enter
cd /path/to/MSMDataCollector

Step 2: Start the Application

Run the following command:

python run_tkinter_ui.py

A desktop window will open with the MSM Data Collector interface.

Application Started

You should see a window with the MSM Data Collector interface and options for different operation modes.

Understanding the Interface

Mode Selection Screen

When you first launch the application, you'll see the mode selection screen:

Mode Selection Screen

The main interface allows you to choose between different operation modes:

  • Online Mode - Extract and upload data in real-time (requires authentication)
  • Offline Mode - Extract data to files for later upload (no authentication required)
  • Upload Mode - Upload previously extracted files (requires authentication)

Authentication

To use Online Mode or Upload Mode, you need to authenticate with your AYK credentials.

Authentication Required

See the Authentication Guide for detailed login instructions.

Quick steps: 1. Click the "Login" button 2. Note the code displayed 3. Enter the code in the browser window that opens 4. Select your AYK account and confirm

After successful authentication, all modes will be available:

Mode Selection - Logged In

Selecting a Mode

After selecting a mode, you'll see controls to configure extraction parameters such as date ranges and batch sizes, along with progress monitoring.

Stopping the Application

To stop the application:

  1. Close the application window using the X button or File menu
  2. If the window becomes unresponsive, you can close the terminal window

Don't Force Close During Extraction

Avoid closing the application during active extraction. Use the Stop button in the interface first, then close the window.

Next Steps

Choose your operation mode:

Troubleshooting

Application Won't Start

  1. Verify Python is installed: python --version
  2. Check dependencies are installed: pip install -r requirements.txt
  3. Verify config.yaml exists in the application folder
  4. Check that tkinter is installed:
  5. Windows/Mac: Should come with Python
  6. Linux: sudo apt-get install python3-tk

Window Doesn't Appear

  1. Check the terminal for error messages
  2. Verify tkinter is available: python -c "import tkinter"
  3. Try running with: python -u run_tkinter_ui.py

Application Freezes

  1. Check the terminal for error messages
  2. Close the window and restart the application
  3. Review logs in logs/extraction.log