Skip to content

Repository files navigation

FS25 Farm Dashboard

Real-time farm management dashboard for Farming Simulator 25 — a Windows desktop app plus an in-game mod that streams live fields, livestock, vehicles, economy, and more to your browser.


Download (start here)

Download from Releases Version
FS25-Farm-Dashboard-Setup-4.2.1.exe Windows app
FS25_FarmDashboard.zip FS25 mod

Current stable line (classic): App 4.2.1 · Mod 3.4.0.7 — hotfix for Farming Simulator 1.21 copyFile log spam (see release notes).

Install mod first, load your save once, then install the app. See docs/INSTALL.md (detailed) or the quick steps below.

Open the dashboard at http://localhost:8766 after setup (same PC only — localhost does not work from a phone or tablet).

Tablet / LAN on your home Wi‑Fi: enable Settings → Remote / LAN access, open http://<this-PCs-LAN-IP>:8766, and use a strong password — see docs/SECURITY.md. You usually do not need router port forwarding for devices on the same network. If the page never loads, check Windows Defender Firewall (or another host firewall / antivirus suite) and allow inbound TCP port 8766 for Farm Dashboard on your Private network profile.


Screenshots

Home Fields
Farm Management Dashboard landing Fields section with summary and cards
Livestock Productions
Livestock summary and animals table Productions storage and chains

More UI shots and install screenshots: docs/USER_MANUAL.md · capture checklist: docs/SCREENSHOTS.md


Quick install

  1. Mod — Put FS25_FarmDashboard.zip in Documents\My Games\FarmingSimulator2025\mods\, enable on your save, load the save once.
  2. App — Run FS25-Farm-Dashboard-Setup-4.2.1.exe from Releases.
  3. ConfigureSettings → Servers & saves (local path or FTP for dedicated servers).

Full guide: docs/USER_MANUAL.md · Install (detailed): docs/INSTALL.md · GitHub Wiki


About this project (fork & lineage)

This repository (FarmHub) is continued development of Josh Walki’s Farm Dashboard — not a separate product.

Project What it is
JoshWalki / FarmDashboard Original FS25 mod + web dashboard (Josh Walki)
WizardlyPayload / FS25-Farm-Dashboard Public 2.0.0 release — Electron desktop fork of Josh’s work
WizardlyPayload / FarmHub (this repo) 4.2.1 classic line — fleet map, storage, FTP/multi-server, rules engine, auto-update

Coming from 2.0.0 or Josh’s repo? See docs/UPGRADE_FROM_FS25-Farm-Dashboard.md for what changed.

Authors: JoshWalki (Josh) — original concept & FS25 mod · WizardlyPayload — Electron app, maintenance, releases · docs/AUTHORS.md


What you get in 4.2.1

  • Live dashboard — livestock, pastures, vehicles, fields, economy, productions, weather (port 8766).
  • Fleet map — live vehicle pins on the save's PDA overview map.
  • Storage — silo stock with moisture & grade, correct names for mod-map and base-map commodities (incl. Pig Food and other sparse fill types); bale categories.
  • Fleet scope — dealership showroom demos no longer clutter player farms on dedicated multiplayer saves.
  • Livestock — base-game cow pens, food-duration hints, urgent pasture alerts.
  • Productions — map-owned factories on base maps; two-column layout.
  • Accurate equipment pictures — authoritative store-icon matching (app 4.2.1 + mod 3.4.0.7).
  • FS 1.21 copyFile hotfix — stops repeated map-overview copy errors in the game log after the 1.21 update.
  • Local + FTP — single-player / LAN host on disk, or dedicated server over FTP.
  • Offline field rules — suggested next steps from merged game data (no cloud service).
  • Optional integrations — Precision Farming, Advanced Damage System, Moisture System, Red Tape, Realistic Livestock RM, Vehicle Years; Courseplay and Used Equipment Yards tested alongside — full mod list.
  • 27 languages, themes, unified Settings.
  • Auto-update (Windows app) and mod version badge when the in-game mod is behind.

Release notes: docs/GITHUB_RELEASE_v4.2.1.md · History: docs/CHANGELOG.md


Documentation

Document Audience
Releases / downloads App installer + mod zip
docs/INSTALL.md Installation (mod → app → setup, with screenshots)
docs/USER_MANUAL.md User manual — every feature
docs/DEVELOPER_HANDOVER.md Developers — architecture & code map
docs/SECURITY.md LAN access & hardening
docs/README.md Full index (public vs internal)
Wiki Mirror of key guides

Repository layout (developers)

Path Role
FS25_FarmDashboard_Mod/ FS25 mod (Lua) — release as FS25_FarmDashboard.zip
FS25_FarmDashboard_App/ Electron app + web UI + merge/FTP layer
tools/ Build scripts — tools/README.md

Build the Windows installer (from repo root — recommended):

npm run install:app    # once, or after pulling dependency changes
npm run build:app      # NSIS installer → %LOCALAPPDATA%\fs25-farm-dashboard-electron-out\
npm run package:mod    # FS25_FarmDashboard.zip → FS25_FarmDashboard_Mod/
npm run build:all      # mod zip + installer

Equivalent from the app folder: cd FS25_FarmDashboard_App && npm install && npm run dist. See root package.json for all delegated scripts (npm run start, npm test, npm run verify, i18n, clean, etc.).

CI on main runs tests, electron-pack verify, and i18n verify — see .github/workflows/ci.yml.


Troubleshooting

Issue Try
“Waiting for data” Mod enabled; save loaded once; check path in Settings
Port 8766 in use Close other apps on that port; restart Farm Dashboard
LAN tablet will not load Enable LAN in Settings; use the PC’s LAN IP (not localhost); allow inbound TCP 8766 in Windows Defender Firewall (Private profile) or your host antivirus firewall; strong password — docs/SECURITY.md
Mod version badge Update FS25_FarmDashboard.zip from Releases
Questions & community Discord — chat, screenshots, quick help

Licence & credits

FarmHub License — free for personal and non-commercial use; commercial use requires permission from the authors (see LICENSE). Copyright JoshWalki & WizardlyPayloaddocs/AUTHORS.md.

Community: Discord · optional maintenance tips: Ko-fi (not required — Farm Dashboard stays free).

About

A dashboard for Farming Simulator 25 for getting info about the farm

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages