🚀 Getting Started & Basic Troubleshooting

Turning TradeMAV On

Basic Steps

1. Plug the USB drive into your computer (any USB 3.0 or USB 2.0 port works)
2. Find the launcher file – Look for START.bat or RUN_TRADEMAV.bat on the USB root
3. Double-click the file to launch TradeMAV
4. Wait 30-60 seconds – The system initializes all background services
5. Browser opens automatically – Shows the TradeMAV dashboard at http://localhost:5001

What Happens During Startup?

Turning TradeMAV Off

Safe Shutdown Methods

1. Via Dashboard: Click the “Stop Screener” button in the Screener Control tab
2. Via Command Line: Press Ctrl+C in the terminal window
3. Safe Eject: Use the “Safe Eject USB” button in System Maintenance tab
4. Finally: Unplug the USB after shutdown completes

Dashboard Won’t Open?

⚙️ First-Time Setup

Setting Up Email Notifications

1. Go to Dashboard → Config Tab
2. Find the “Email Configuration” section
3. Enter your email address (must be valid format like example@gmail.com)
4. For Gmail users: Generate an App Password at Google Account Settings
5. Copy the 16-character app password and paste into “Email Password” field
6. Click “Test Email” to verify (check spam folder if not received)
7. Click “Save Configuration” to finalize

Adding Your First Watchlist

Watchlist = the stocks you want TradeMAV to screen

Option 1: Use Presets (Easiest)

1. Go to Config Tab → Watchlist section
2. Click “Load Default Watchlist”
3. Automatically adds popular stocks: AAPL, MSFT, GOOGL, TSLA, AMZN, etc.

Option 2: Add Manually

1. Find the “Add Ticker” field
2. Type a stock symbol (e.g., “AAPL” for Apple)
3. Click “Add” or press Enter
4. Repeat for each stock

Starting Your First Screening

1. Go to Screener Control tab
2. Set screening interval (default: 30 minutes)
3. Choose mode: Stock, Crypto, or Both
4. Click “Start Screener”
5. Monitor progress in Live Activity Monitor

💾 USB & Hardware Management

What’s on the USB?

TradeMAV/ (root directory)
├── app/
│   ├── main.py (main launcher)
│   ├── screener.py (signal detection engine)
│   └── app.js (dashboard frontend)
├── data/
│   ├── ultimate_options_trading.db (stock signals database)
│   ├── cryptosignals.db (cryptocurrency signals database)
│   ├── config.json (your settings)
│   └── signal_configs.json (signal thresholds)
├── START.bat (Windows launcher)
└── [Other system files]

USB Safe Eject

Method 1: Via Dashboard (Recommended)

1. Go to System Maintenance tab
2. Click “Safe Eject USB”
3. Wait for confirmation message: “Safe to remove USB”
4. Now unplug the USB drive

USB Duplication Tool

Purpose: Create a complete copy of TradeMAV on a second USB drive for backup or multi-computer use.

1. Insert the target USB drive
2. Go to Dashboard → Config Tab
3. Find “USB Duplication Tool” section
4. Click “Select Target USB Drive”
5. Click “Start Duplication” and wait 5-15 minutes

🔧 USB Troubleshooting

Database Locked Error

1. Click “Stop Screener” button
2. Wait 5 seconds for database to release
3. Try your operation again
4. If persists: Restart TradeMAV completely

📊 Dashboard Overview & Navigation

Dashboard Tabs

🎯 Screener Control (In-Depth)

Screening Modes

Stock Mode (Default)

• Only screens stocks
• Runs during market hours: 9:30 AM – 4:00 PM ET (Mon-Fri)
• Sleeps outside market hours to save API calls

Crypto Mode

• Screens cryptocurrency pairs (BTC/USDT, ETH/USD, etc.)
• Runs 24/7 (cryptocurrency trades always)
• Uses separate ML models and database

Screening Intervals

📝 Watchlist Management

Adding Stocks

Method 1: Preset Watchlists

Method 2: Manual Addition

1. Find the “Add Ticker” input field
2. Type stock symbol (e.g., “AAPL”)
3. Click “Add” button or press Enter
4. Repeat for additional stocks

Best Practices

• 15-30 stocks: Optimal balance
• 50% Large-cap: AAPL, MSFT, GOOGL
• 30% Mid-cap: NVDA, MA, V
• 20% Sector-specific: Your interests

📈 Understanding Signals

Signal Components

Filtering & Sorting

• Show BUY only: Display only buying opportunities
• Show SELL only: Display only selling opportunities
• By Confidence: Most reliable signals first
• By Return: Highest profit potential first

⚙️ Strategy Configuration (22 Signals)

The 22 Signals Overview

Signal Controls

Sensitivity Slider

• Low (0.1-0.3): MORE signals (aggressive)
• Medium (0.4-0.6): Balanced (recommended)
• High (0.7-0.9): FEWER signals (conservative)

Strategy Presets

• Conservative: High quality, 2-5 signals/day
• Balanced: Medium quality, 5-15 signals/day
• Aggressive: High volume, 20+ signals/day

📊 Performance Analytics

Key Metrics

Performance Interpretation

₿ Cryptocurrency Trading

Enabling Crypto Mode

1. Go to Config Tab
2. Find “Crypto Mode” toggle
3. Click to enable (switch to ON)
4. Crypto features activate

Recommended Crypto Pairs

• BTC/USDT – Bitcoin (highest liquidity)
• ETH/USD – Ethereum
• XRP/USDT – Ripple
• ADA/USDT – Cardano
• SOL/USDT – Solana

💾 Database Management & Backups

Full Application Backup

1. Go to Database Tab
2. Click “Create Full Backup”
3. Wait 30 sec – 2 min for completion
4. Backup saves to .full_backup/ folder

Restore from Backup

1. Stop the screener
2. Go to Database Tab
3. Select backup date from dropdown
4. Click “Restore from Backup”
5. Restart TradeMAV

Factory Reset

🔧 System Maintenance

File Repair Tool

1. Go to System Maintenance tab
2. Find “File Repair” section
3. Click “Run File Repair”
4. System downloads fresh copies of corrupted files
5. Takes 2-5 minutes

Update TradeMAV

1. Click “Check for Updates”
2. If update available: Click “Install Update”
3. Backup created automatically
4. Update downloads and installs (5-10 min)
5. Restart required

Log Management

• View Logs: Opens log file in browser
• Clear Logs: Deletes old entries, keeps last 1000 lines

❓ Frequently Asked Questions

General Questions

Q: Do I need an internet connection?

A: Yes, for real-time data and signal detection. TradeMAV can run offline if you disable screening.

Q: Can I run TradeMAV on Mac or Linux?

A: Currently optimized for Windows. Mac/Linux support requires Python installation and manual setup.

Q: How accurate are the signals?

A: Historical backtesting shows 60-70% win rate on average. Performance varies by market conditions.

Q: What happens if I unplug the USB while running?

A: Risk of database corruption. Always use Safe Eject. If corrupted, use File Repair or restore from backup.

Technical Questions

Q: Can I screen more than 100 stocks?

A: Yes with premium data tier (FMP, Intrinio, Polygon). Free tier (yfinance) limited to ~100 due to rate limits.

Q: System Requirements?

• OS: Windows 10/11 (64-bit)
• RAM: 4GB minimum, 8GB recommended
• Storage: 2GB free space on USB
• Internet: Broadband connection

🔍 Troubleshooting Guide

Error Messages Explained

“Connection Refused”

“API Rate Limit Exceeded”

Getting Help