⚙️Settings

HiveFB offers extensive configuration options to customize your experience. This guide covers all available settings in both the main application and web dashboard.

You’ll learn

• Where settings live (main app vs dashboard).

• Which defaults matter most.

• How to reset safely.

Main App Settings

Accessing Settings

1

Open Settings

• Click "⚙️ Settings" in the sidebar

• Settings modal opens

Screenshot placeholder: Main app Settings modal showing categories/tabs.

2

Navigate Sections

• Use tabs or sections

• Different categories available

• Save changes when done

Scraping Parameters

Default Values:

• Search Term: Default search term (optional)

• Max Listings: Default maximum (default: 500)

• Scroll Speed: Default delay (default: 2000ms)

• Page Load Wait: Default wait time (default: 10000ms)

How to Use:

• Set defaults for new scrapes

• Override when starting scrape

• Saves time on repeated settings

Browser Settings

Automation Browser:

• Browser Type: Chrome/Chromium selection

• Headless Mode: Run without visible browser (advanced)

• User Agent: Browser identification string

• Viewport Size: Browser window dimensions

Connection:

• Timeout Settings: Connection timeouts

• Retry Attempts: Failed operation retries

• Connection Pool: Browser connection management

Data Management

Storage:

• Data Location: Where data is stored

• Database Path: SQLite database location

• Backup Settings: Automatic backup configuration

Cleanup:

• Auto-Cleanup: Remove old data automatically

• Retention Period: How long to keep data

• Archive Settings: Archive old listings

Appearance

UI Preferences:

• Theme: Light/dark mode (if available)

• Font Size: Text size preferences

• Layout: Interface layout options

Dashboard Settings

Accessing Settings

1

Open Dashboard

• Navigate to dashboard

• Click "⚙️ Settings" in navigation

Screenshot placeholder: Dashboard Settings page opened from the top navigation.

2

Configure Preferences

• Multiple sections available

• Save to apply changes

Display Preferences

Listings Display:

• Items Per Page: How many listings per page

• Default Sort: Default sorting method

• Default Filter: Default type filter (All/Vehicles/Items)

• Card Size: Listing card size preference

View Options:

• Show Images: Display listing images

• Show Descriptions: Show full descriptions

• Compact Mode: More listings per page

Refresh Settings

Auto-Refresh:

• Enable/Disable: Turn auto-refresh on/off

• Refresh Interval: How often to refresh (default: 10 seconds)

• Background Refresh: Refresh when tab not active

Manual Refresh:

• Refresh Button: Manual refresh option

• Keyboard Shortcut: Quick refresh key

Filter Defaults

Default Filters:

• Type Filter: Default type selection

• Price Range: Default price filter

• Sort Order: Default sort direction

Saved Filters:

• Save Current Filter: Save filter as default

• Reset to Defaults: Restore original defaults

Break Settings

What are Breaks?

Breaks are automatic pauses during scraping that:

• Prevent rate limiting

• Reduce detection risk

• Mimic human behavior

• Protect your account

Break Types

Micro Breaks:

• Duration: 1-5 seconds

• Frequency: Every few listings

• Purpose: Small natural pauses

Normal Breaks:

• Duration: 5-30 seconds

• Frequency: Every 10-20 listings

• Purpose: Medium pauses

Sleep Breaks:

• Duration: 30+ seconds

• Frequency: Every 50+ listings

• Purpose: Longer pauses

Configuring Breaks

Per Catalogue:

• Set when creating/editing catalogue

• Specific to that catalogue

• Overrides global settings

Global Settings:

• Apply to all scrapes

• Default break configuration

• Can be overridden per catalogue

Break Parameters:

• Max Continuous Time: How long before break

• Break Duration: How long to pause

• Frequency: How often breaks occur

• Skip Threshold: Minimum time before skip allowed

Screenshot placeholder: Break settings UI showing micro/normal/sleep break fields.

Break Benefits

• Account Safety: Reduces risk of issues

• Rate Limiting: Prevents Facebook throttling

• Natural Pattern: More human-like behavior

• Better Results: More reliable scraping

Advanced Settings

Performance

Scraping Performance:

• Concurrent Operations: Parallel processing (advanced)

• Memory Limits: RAM usage limits

• CPU Throttling: Reduce CPU usage

Database Performance:

• Query Optimization: Database query settings

• Index Management: Database index configuration

• Cache Settings: Data caching preferences

Security

Credential Management:

• Encryption: Credential encryption settings

• Storage Location: Where credentials stored

• Auto-Logout: Automatic logout settings

Data Privacy:

• Local Storage Only: Ensure no external transmission

• Data Retention: How long to keep data

• Export Settings: Data export preferences

Resetting Settings

Reset to Defaults (Main App & Dashboard)

1

Main App

• Open Settings

• Look for "Reset to Defaults" button

• Confirm reset

• All settings restored

Screenshot placeholder: “Reset to Defaults” button (main app and/or dashboard).

2

Dashboard

• Open Dashboard Settings

• Find reset option

• Confirm action

• Settings restored

Selective Reset

• Reset individual sections

• Keep custom settings

• Restore specific categories

• More granular control

Settings Best Practices

1. Start with Defaults: Use defaults initially, adjust as needed

2. Test Changes: Test settings before major changes

3. Document Custom Settings: Note any custom configurations

4. Backup Settings: Export settings if possible

5. Regular Review: Review settings periodically

Configuration Files

Location

Main App:

• AppData\Roaming\HiveFB\settings.json

• Application-specific settings

• User preferences

Dashboard:

• Stored in database

• Per-user preferences

• Session-based

Backup

Manual Backup:

• Copy settings files

• Store in safe location

• Restore if needed

Automatic Backup:

• If enabled in settings

• Regular backups created

• Restore from backup

FAQ

Open FAQ

See the FAQ page: FAQ