ScreenerBot
DocsGetting StartedDashboard Access
ScreenerBot
ScreenerBot

Need Help?

Join our community for support, updates, and trading discussions.

Telegram CommunityFollow on X (Twitter)Contact Support

Dashboard Access & Navigation

The ScreenerBot dashboard is your central control interface for monitoring positions, managing trades, configuring settings, and analyzing performance. This guide will help you navigate and understand every part of the dashboard.

Accessing Your Dashboard

Desktop (GUI Mode)

The dashboard opens automatically in the native application window when you launch ScreenerBot. No browser needed — just start the app.

Browser Access (Headless)

For VPS or server deployments, access via browser at:http://localhost:8080

Startup Time: typically under a minute depending on your machine and network

First Launch Sequence

After completing the initial setup, start ScreenerBot and wait for the services to initialize. Here's what happens:

1

Bot Starts

Loads configuration and validates wallet connection

2

Services Init

Background services start in dependency order

3

Dashboard Ready

GUI window opens or web server becomes accessible

4

Full Sync

Data syncing begins and trading system activates

First Launch Tip

The first time you access the dashboard, some data may be empty or loading. This is normal. Token discovery, pool analysis, and wallet sync happen in the background and will populate within a few minutes.

Dashboard Interface Overview

The dashboard uses a modern, three-row header layout with real-time status indicators and easy navigation.

Header Components

1Row 1: Control Bar

Brand Logo

ScreenerBot branding, clickable to return home

Bot Status Card

Trading status (ACTIVE/STOPPED) and total P&L

Wallet Card

SOL balance, daily change, token count, and worth

Positions Card

Open positions count, unrealized P&L, RPC health

2Quick Actions (Right Side)

Notifications

View recent events and alerts

Refresh Interval

Adjust auto-refresh rate (5s, 10s, 30s, manual)

Theme Toggle

Switch between light and dark themes

Settings

Quick access to configuration options

3Row 2: Navigation Tabs

Horizontal tabs for switching between major dashboard sections. Active tab is highlighted in blue.

4Row 3: Live Ticker

Scrolling ticker showing real-time updates: recent trades, new tokens discovered, system events, and price changes.

Dashboard Pages

The dashboard is organized into 12 main pages, each focused on a specific aspect of bot operation:

Home
Dashboard

Your main dashboard with wallet overview, trader analytics, open positions summary, and quick statistics.

Positions
Trading

Manage all your trading positions - view open positions, execute manual trades, and review closed position history.

Tokens
Market Data

Browse all discovered tokens with comprehensive market data, security analysis, and pool information.

Filtering
Analysis

Monitor the token filtering process - see which tokens passed filters, which were rejected, and why.

Trader
Automation

Control automated trading - start/stop the trader, monitor entry/exit activity, and view trading statistics.

Strategies
Logic

Create and manage trading strategies with custom conditions for entry and exit signals.

Wallet
Finance

Monitor your wallet in detail - balance history, token holdings, SOL flow analysis, and export data.

Transactions
Monitoring

Real-time transaction monitoring with detailed analysis, swap detection, and P&L calculations.

Events
Logs

View system events log with filtering, search, and severity levels for debugging and analysis.

Configuration
Settings

Edit all bot configuration through the web UI - trader settings, filters, swaps, and more.

Services
System

Monitor all bot services - view status, health indicators, performance metrics, and dependencies.

Initialization (First-Time Only)

Special page shown on first launch when no config.toml exists. Guides you through initial setup.

First-time setup wizard

Wallet configuration

RPC setup

Note: This page auto-redirects away after initial configuration is complete

Navigation Tips

Keyboard Shortcuts

Cycle navigationTab
Activate itemEnter
Close modalsEsc

Auto-Refresh

•Dashboard auto-refreshes frequently by default

•Use the refresh menu to choose faster, slower, or manual updates

•Click the refresh icon any time you want an immediate update

•Manual mode helps minimize bandwidth usage on slower connections

Theme Customization

•Toggle between light and dark themes

•Theme preference saved in browser

•Syncs across tabs automatically

•Dark theme recommended for extended use

Notifications Panel

•Click bell icon to view recent events

•Badge shows unread notification count

•Quick access to important alerts

•Click notification to jump to details

Troubleshooting Dashboard Access

Can't Access Dashboard

Problem: Browser shows "Connection refused" or "Page not loading"

Solutions:

  • Verify ScreenerBot is running (check terminal/logs)
  • Give the bot a short moment after startup for the dashboard service to come online
  • Confirm URL is exactly http://localhost:8080
  • Check if another application is using port 8080
  • Try accessing from a different browser

Dashboard Loading Slowly

Problem: Pages take a long time to load or update

Solutions:

  • Increase auto-refresh interval to 30s or manual
  • Check RPC endpoint performance (slow RPC = slow dashboard)
  • Close unused browser tabs
  • Clear browser cache and reload
  • Check system resources (CPU/RAM usage)

Data Not Updating

Problem: Dashboard shows old data, no real-time updates

Solutions:

  • Click the refresh icon to force manual update
  • Check auto-refresh is enabled (not set to "manual")
  • Verify bot is running and services are healthy (Services page)
  • Check console for JavaScript errors (F12 → Console tab)
  • Try hard refresh: Ctrl+F5 (Windows/Linux) or Cmd+Shift+R (macOS)

Some Pages Missing or Broken

Problem: Certain dashboard pages don't load or show errors

Solutions:

  • Check Services page to see if relevant services are running
  • Restart ScreenerBot to reinitialize all services
  • Check Events page for error messages
  • Clear browser cache completely and restart browser
  • Try accessing from a different device to rule out browser issues

Dashboard Best Practices

Keep Dashboard Open

Monitor positions and trading activity in real-time. Use a dedicated browser window or tab.

Check Services Regularly

Visit the Services page to ensure all critical services are running and healthy.

Review Events

Check the Events page daily for warnings, errors, or unusual activity.

Adjust Refresh Rate

Use faster refresh (5s) during active trading, slower (30s) or manual during idle times.

Bookmark Key Pages

Create browser bookmarks for frequently used pages (Positions, Trader, Filtering).

Ready to Explore!

Now that you know how to access and navigate the dashboard, you're ready to explore each section in detail and configure your trading parameters.

Next: Home Dashboard TourSystem Configuration