🚀Getting Started

This guide will help you install HiveFB and set it up for your first scraping session.

You’ll do this

• Install HiveFB.

• Add your Facebook account.

• Verify automation is connected.

• Run your first scrape.

System Requirements

Component	Minimum	Recommended
Operating System	Windows 10+	Windows 11
RAM	4GB	8GB+
Storage	1GB free	5GB+
Internet	Broadband	High-speed
Browser	Chrome/Chromium	Latest Chrome

Installation

1

Download HiveFB

• Visit the GitHub releases page

• Download the latest version

• Choose either:

  • Setup Installer: Full installation with shortcuts (recommended)

  • Portable Version: No installation required

Screenshot placeholder: GitHub Releases page with the correct asset highlighted (Setup vs Portable).

2

Install the Application

For Setup Installer:

• Run the installer executable

• Follow the installation wizard

• Choose installation location (default recommended)

• Complete the installation

For Portable Version:

• Extract the ZIP file to your desired location

• Run HiveFB.exe directly

Screenshot placeholder: Installer wizard (or extracted portable folder) showing HiveFB.exe.

3

Launch HiveFB

• Find "HiveFB" in your Start Menu

• Or double-click the desktop shortcut

• The HiveFB Loader will verify your subscription

• Once verified, the main application launches

Screenshot placeholder: HiveFB Loader verification screen (if shown) and the main window after launch.

First Time Setup

1

Login to Facebook

• Open Account Manager:

  • Click "👤 Account Manager" in the sidebar

  • Or use the account icon in the top navigation

• Add Your Credentials:

  • Enter your Facebook email address

  • Enter your Facebook password

  • Click "Add Account"

• Security Note:

  • Your credentials are encrypted and stored locally

  • They are never transmitted to external servers

  • Only used for Facebook Marketplace access

Screenshot placeholder: Account Manager screen with the “Add Account” form (hide personal info).

2

Verify Connection

• Check Status Light:

  • Look for the green status light (🟢) in the top right corner

  • Green = Automation connected and ready

  • Red (🔴) = Connection issue (see Troubleshooting)

• Test Browser Connection:

  • The Browser tab should show a live view

  • If blank or showing errors, check the troubleshooting guide

Screenshot placeholder: Top-right status light in green (🟢) plus the Browser tab showing a live page.

3

Start Your First Scrape

• Click "🚀 Start Scraping" (located in the sidebar navigation)

• Select Mode:

  • Choose "Vehicle Mode" for cars, trucks, motorcycles, etc.

  • Or "Item Mode" for general marketplace items

• Configure Your Search:

  • Search Term: Enter what you're looking for (e.g., "civic", "truck", "suv")

  • Max Listings: How many to collect (default: 500)

  • Scroll Speed: Delay between scrolls (default: 2000ms)

  • Page Load Wait: Time to wait for pages (default: 10000ms)

• Start Scraping:

  • Click "Start Scraping"

  • Monitor progress in the Console tab

  • Watch the Browser tab to see automation in action

Screenshot placeholder: “Start Scraping” modal with example values filled in.

Next Steps

Now that you're set up, explore these features:

• Main App: Learn the interface

• Scraping Guide: Run scrapes confidently

• Web Dashboard: View and filter data

• Catalogue Management: Save searches for reuse

Troubleshooting

See the troubleshooting guide: Troubleshooting

FAQ

See the FAQ: FAQ