Skip to content
Β 
Β 

Latest commit

Β 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

openpilot on the comma 3X

What is openpilot?

openpilot is an open source driver assistance system. Currently, openpilot performs the functions of Adaptive Cruise Control (ACC), Automated Lane Centering (ALC), Forward Collision Warning (FCW), and Lane Departure Warning (LDW) for a growing variety of supported car makes, models, and model years. In addition, while openpilot is engaged, a camera-based Driver Monitoring (DM) feature alerts distracted and asleep drivers. See more about the vehicle integration and limitations.

What is FrogPilot? 🐸

FrogPilot is a fully open-sourced fork of openpilot, featuring clear and concise commits striving to be a resource for the openpilot developer community. It thrives on contributions from both users and developers, focusing on a collaborative, community-led approach to deliver an advanced openpilot experience for everyone!


FrogPilot was last updated on:

April 12th, 2025


Features

πŸ”Š Alerts & Sounds

Alert Volume Controller

Description: Individually adjust the volume of each alert category (Engage/Disengage, Prompt, Warning, etc.).

How to Enable: Settings β†’ Visuals β†’ Alert Volume Controller

Green Light Alert

Description: Plays a chime when the traffic light ahead turns green.

How to Enable: Settings β†’ Visuals β†’ Custom Alerts

Lead Departing Alert

Description: Notifies you when the stopped lead car pulls away.

How to Enable: Settings β†’ Visuals β†’ Custom Alerts

Speed Limit Change Alert

Description: Chimes whenever the posted speed limit changes.

How to Enable: Settings β†’ Visuals β†’ Custom Alerts


πŸ›  Device & System

Automatic Updates

Description: Downloads and installs new FrogPilot versions automatically when off-road.

How to Enable: Settings β†’ Software β†’ Auto-Update

Battery Monitor (Auto-Shutdown)

Description: Shuts down the device if 12 V battery voltage drops below a set threshold.

How to Enable: Settings β†’ Device β†’ Battery Shutdown

Delete Driving Data

Description: Erases all stored logs and video footage with one tap.

How to Enable: Settings β†’ Device β†’ Delete Driving Data

Device Shutdown Timer

Description: Powers down the device X minutes after the car turns off.

How to Enable: Settings β†’ Device β†’ Off-road Shutdown Timer

Disable Logging

Description: Stops local drive logging for privacy and reduced storage wear.

How to Enable: Settings β†’ Device β†’ Disable Logging

Disable Onroad Uploads

Description: Prevents data uploads while driving; uploads only when parked on Wi-Fi.

How to Enable: Settings β†’ Network β†’ Uploads Only Off-road

Disable Uploads

Description: Blocks all cloud uploads for maximum privacy.

How to Enable: Settings β†’ Network β†’ Disable Uploads

Enable Offline Mode

Description: Lets FrogPilot run indefinitely with zero internet or Comma account.

How to Enable: Settings β†’ Device β†’ Offline Indefinitely

Enable SSH Access

Description: Turns on the SSH server for remote shell access.

How to Enable: Settings β†’ Network β†’ Enable SSH

Enable Tethering (Hotspot)

Description: Starts the device’s Wi-Fi hotspot (Off, On-road Only, or Always).

How to Enable: Settings β†’ Network β†’ Tethering

Flash Panda (Reflash Panda Firmware)

Description: One-tap recovery/upgrade of the Panda CAN-interface firmware.

How to Enable: Settings β†’ Device β†’ Flash Panda

FrogPilot Backups

Description: Backup/restore the entire FrogPilot software state.

How to Enable: Settings β†’ Device β†’ Backups β†’ Create/Restore

Reset Toggles to Default

Description: Restores every toggle to factory defaults.

How to Enable: Settings β†’ Device β†’ Reset Toggles

Toggle Backups

Description: Save or restore only your toggle configuration profiles.

How to Enable: Settings β†’ Device β†’ Backups β†’ Backup/Restore Toggles


πŸš— Driving Features

Acceleration Profile

Description: Choose Sport (quick) or Eco (gentle) acceleration behavior.

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning β†’ Acceleration Profile

Always On Lateral

Description: Keeps lane-centering active without cruise; optional pause on brake/signal/low-speed.

How to Enable: Settings β†’ Controls β†’ Always On Lateral

Conditional Experimental Mode

Description: Auto-switches to Experimental Mode for sharp turns, intersections, slow traffic, etc.

How to Enable: Settings β†’ Controls β†’ Conditional Experimental Mode

Custom Driving Personalities

Description: Fine-tune following distance and responsiveness for Relaxed, Standard, Aggressive, and Traffic profiles.

How to Enable: Settings β†’ Controls β†’ Driving Personalities β†’ Customize

Deceleration Profile

Description: Sport or Eco style braking when slowing down.

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning β†’ Deceleration Profile

Experimental Mode Shortcuts

Description: Toggle Experimental Mode via double-tap screen, long-press distance, or double-click LKAS.

How to Enable: Settings β†’ Controls β†’ Experimental Mode Activation

Force Auto Tune (Unsupported Cars)

Description: Forces steering calibration on unofficial car models.

How to Enable: Settings β†’ Controls β†’ Force Auto Tuning

Increase Acceleration Behind Lead

Description: Accelerates faster when the lead car starts moving.

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning

Increase Set Speed Increment

Description: Change cruise-speed step size (e.g., 5 mph per tap).

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning

Increase Stopping Distance Behind Lead

Description: Stops farther back from lead vehicles at red lights/traffic.

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning

Lane Change Timer

Description: Set a delay before automatic lane changes execute.

How to Enable: Settings β†’ Controls β†’ Lane Change Customizations

Lane Detection Threshold

Description: Adjust how strong lane lines must be before lane change is allowed.

How to Enable: Settings β†’ Controls β†’ Lane Change Customizations

Lead Detection Threshold

Description: Tune how early/late the system reacts to a lead vehicle.

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning

Map Turn Speed Controller

Description: Slows for upcoming curves using map data; adjustable aggressiveness.

How to Enable: Settings β†’ Controls β†’ Map Turn Speed Control

Minimum Lane Change Speed

Description: Configure the minimum speed at which auto lane changes initiate.

How to Enable: Settings β†’ Controls β†’ Lane Change Customizations

Model Selector

Description: Download and switch between Present, Past, and Experimental driving models.

How to Enable: Settings β†’ Controls β†’ Model Selector

Nudgeless Lane Change

Description: Executes lane changes with signal only – no steering nudge required.

How to Enable: Settings β†’ Controls β†’ Lane Change Customizations

One Lane Change Per Signal

Description: Limits to one lane change per turn-signal toggle.

How to Enable: Settings β†’ Controls β†’ Lane Change Customizations

Pause Below Speed (Lateral)

Description: Temporarily pauses lane-centering below a chosen speed.

How to Enable: Settings β†’ Controls β†’ Always On Lateral

Pause On Brake (Lateral)

Description: Brake pedal pauses steering assist instead of fully disengaging it.

How to Enable: Settings β†’ Controls β†’ Always On Lateral

Pause On Turn Signal (Lateral)

Description: Pauses lane-centering while your turn signal is active.

How to Enable: Settings β†’ Controls β†’ Always On Lateral

Smoother Braking

Description: Gentler deceleration when approaching slower traffic.

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning

Speed Limit Controller

Description: Auto-sets cruise speed to the posted limit with configurable offsets.

How to Enable: Settings β†’ Controls β†’ Speed Limit Controller

Steer Ratio

Description: Override the steering ratio used for lateral control.

How to Enable: Settings β†’ Controls β†’ Lateral Tuning

Traffic Mode

Description: Hold distance button ~2.5 s to activate extra-smooth stop-and-go profile (UI turns red).

How to Enable: Settings β†’ Controls β†’ Longitudinal Tuning
(Activate on-road by distance-button hold)

Turn Desires (Precise Turns)

Description: Allows sharper steering at low speed using model β€œturn desires”.

How to Enable: Settings β†’ Controls β†’ Lateral Tuning

Twilsonco's NNFF Steering

Description: Uses a neural-network feed-forward steering controller (full or Lite).

How to Enable: Settings β†’ Controls β†’ Lateral Tuning

Vision Turn Speed Controller

Description: Slows for curves detected by the camera (no map required); adjustable sensitivity.

How to Enable: Settings β†’ Controls β†’ Vision Turn Speed Controller


πŸ—ΊοΈ Navigation Features

3D Buildings on Map

Description: Renders 3-D building models on the navigation map in supported areas.

How to Enable: Settings β†’ Navigation β†’ Show 3D Buildings

Custom Map Styles

Description: Choose alternative color themes (dark, high-contrast, etc.) for the map.

How to Enable: Settings β†’ Navigation β†’ Map Style

iOS Shortcuts Integration

Description: Use Siri/iOS Shortcuts to send destinations to FrogPilot instantly.

How to Enable: Install the provided iOS Shortcut β†’ Trigger via Siri or tap

Navigate on OpenPilot (No Comma Prime)

Description: Full turn-by-turn routing without a subscription.

How to Enable: Settings β†’ Navigation (Primeless Navigation enabled by default)

Offline Maps

Description: Download regions for completely offline routing and map tiles.

How to Enable: Settings β†’ Navigation β†’ Download Offline Maps

OpenStreetMap Integration

Description: Uses OSM data for road names, speed limits, and routing (always on).

How to Enable: Enabled by default (ensure offline maps downloaded for no-cell service)


🎨 User Interface

Big Map (Full-Screen Map)

Description: Expands the navigation map to cover most or all of the screen.

How to Enable: Settings β†’ Visuals β†’ Map Display β†’ Full-Screen Map

Camera View

Description: Select wide, normal, or auto camera perspective for the on-road feed.

How to Enable: Settings β†’ Visuals β†’ Camera View

Color Theme

Description: Swap the entire UI color palette (Frog, Tesla, holiday themes, etc.).

How to Enable: Settings β†’ Visuals β†’ Custom Themes β†’ Color Theme

Compass

Description: Shows a live compass heading on the on-road screen.

How to Enable: Settings β†’ Visuals β†’ Custom On-road UI β†’ Compass

Developer UI (Border Metrics)

Description: Uses the screen border to show metrics like blind-spot or steering torque.

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ Border Metrics

Developer UI (FPS Counter)

Description: Displays real-time UI frames-per-second.

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ FPS Counter

Developer UI (Lateral Metrics)

Description: Shows live steering-control numbers/graphs.

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ Lateral Metrics

Developer UI (Longitudinal Metrics)

Description: Displays acceleration/braking metrics on screen.

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ Longitudinal Metrics

Developer UI (Numerical Temperature Gauge)

Description: Replaces β€œOK/HIGH” with exact Β°C/Β°F device temps.

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ Numerical Temp Gauge

Developer UI (Sidebar Stats)

Description: Adds CPU, GPU, memory, IP, and storage stats to the sidebar (tap to cycle views).

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ Sidebar Stats

Developer UI (Use SI Units)

Description: Switches Developer UI metrics to metric/SI units.

How to Enable: Settings β†’ Visuals β†’ Developer UI β†’ Use SI Units

Driver Camera on Reverse

Description: Shows the driver-facing camera feed when you shift into reverse.

How to Enable: Settings β†’ Visuals β†’ Quality of Life β†’ Driver Camera on Reverse

Driving Statistics on Home

Description: Displays lifetime/weekly drive stats on the launcher home screen.

How to Enable: Settings β†’ Device β†’ Drive Stats on Home Screen

Fleet Manager

Description: Browse, replay, and manage your recorded drives directly on the device.

How to Access: Home screen β†’ Fleet Manager (or Settings β†’ Device β†’ Fleet Manager)

Hide Speed

Description: Removes the speedometer from the UI (optional tap-to-show).

How to Enable: Settings β†’ Visuals β†’ Quality of Life β†’ Hide Speed

Hide UI Elements

Description: Granularly hide lane lines, icons, sidebar gauges, etc.

How to Enable: Settings β†’ Visuals β†’ Screen Management β†’ Hide UI Elements

Icon Pack

Description: Replace default icons with themed packs (Tesla icons, custom sets, etc.).

How to Enable: Settings β†’ Visuals β†’ Custom Themes β†’ Icon Pack

Lane Line Width

Description: Adjust the thickness of lane lines drawn on the UI.

How to Enable: Settings β†’ Visuals β†’ Model UI β†’ Lane Line Width

Lead Marker (Hide Lead Indicator)

Description: Hides the lead-vehicle icon for a cleaner view.

How to Enable: Settings β†’ Visuals β†’ Model UI β†’ Hide Lead Vehicle Marker

Map Style

Description: Change the map’s color theme to dark, retro, high-contrast, etc.

How to Enable: Settings β†’ Visuals β†’ Quality of Life β†’ Map Style

Path Edge Width

Description: Make the colored edge highlights of the path thicker/thinner.

How to Enable: Settings β†’ Visuals β†’ Model UI β†’ Path Edges Width

Path Width

Description: Adjust the main driving path line’s thickness.

How to Enable: Settings β†’ Visuals β†’ Model UI β†’ Path Width

Pedals Indicator

Description: On-screen icons light up when gas or brake pedals are pressed (manual or system).

How to Enable: Settings β†’ Visuals β†’ Custom On-road UI β†’ Pedal Indicators

Random Events

Description: Enables occasional fun Easter-egg graphics/sounds.

How to Enable: Settings β†’ Visuals β†’ Custom Themes β†’ Random Events

Road Edges Width

Description: Adjust road-edge line thickness in the visualization.

How to Enable: Settings β†’ Visuals β†’ Model UI β†’ Road Edge Line Width

Road Names Display

Description: Shows the current road/street name on screen.

How to Enable: Settings β†’ Visuals β†’ Custom On-road UI β†’ Show Road Name

Screen Brightness (Off-road)

Description: Set screen brightness when parked or in menus.

How to Enable: Settings β†’ Device β†’ Screen β†’ Brightness (Off-road)

Screen Brightness (On-road)

Description: Set screen brightness while driving.

How to Enable: Settings β†’ Device β†’ Screen β†’ Brightness (On-road)

Screen Recorder

Description: Records the on-screen UI during drives.

How to Enable: Settings β†’ Device β†’ Screen β†’ Enable Screen Recorder

Screen Timeout (Off-road)

Description: Auto-turns off the screen after X minutes when off-road.

How to Enable: Settings β†’ Device β†’ Screen β†’ Screen Timeout (Off-road)

Screen Timeout (On-road)

Description: Auto-turns off the screen after X minutes while driving (use with Standby Mode).

How to Enable: Settings β†’ Device β†’ Screen β†’ Screen Timeout (On-road)

Standby Mode

Description: Lets the screen sleep but wakes instantly for alerts/engagement changes.

How to Enable: Settings β†’ Device β†’ Screen β†’ Standby Mode

Steering Wheel Icon (Custom)

Description: Swap steering-wheel graphic; icon rotates with your wheel in real time.

How to Enable: Settings β†’ Visuals β†’ Custom On-road UI β†’ Custom Steering Icon

Stopped Timer

Description: Shows how long you’ve been stopped at a light or in traffic.

How to Enable: Settings β†’ Visuals β†’ Quality of Life β†’ Stopped Timer

Turn Signal Animation

Description: Adds animated blinker graphics (theme dependent).

How to Enable: Settings β†’ Visuals β†’ Custom Themes β†’ Animated Turn Signals

Wheel Speed in UI

Description: Uses wheel-sensor speed (more accurate) for the UI and logic.

How to Enable: Settings β†’ Visuals β†’ Quality of Life β†’ Use Wheel Speed


🧰 How to Install

Easiest way to install FrogPilot is via this URL at the installation screen:

frogpilot.download

DO NOT install the "FrogPilot-Development" branch. I'm constantly breaking things on there, so unless you don't want to use openpilot, NEVER install it!


🐞 Bug reports / Feature Requests

If you encounter any issues or bugs while using FrogPilot, or if you have any suggestions for new features or improvements, please don't hesitate to post about it on the Discord! I'm always looking for ways to improve the fork and provide a better experience for everyone!

To report a bug or request a new feature, make a post in the #bug-reports or #feature-requests channel respectively on the FrogPilot Discord. Please provide as much detail as possible about the issue you're experiencing or the feature you'd like to see added. Photos, videos, log files, or other relevant information are very helpful!

I will do my best to respond to bug reports and feature requests in a timely manner, but please understand that I may not be able to address every request immediately. Your feedback and suggestions are valuable, and I appreciate your help in making FrogPilot the best it can be!


πŸ“± Discord

Join the FrogPilot Community Discord!


πŸ“‹ Credits


βš–οΈ Licensing

openpilot is released under the MIT license. Some parts of the software are released under other licenses as specified.

Any user of this software shall indemnify and hold harmless Comma.ai, Inc. and its directors, officers, employees, agents, stockholders, affiliates, subcontractors and customers from and against all allegations, claims, actions, suits, demands, damages, liabilities, obligations, losses, settlements, judgments, costs and expenses (including without limitation attorneys’ fees and costs) which arise out of, relate to or result from any use of this software by user.

THIS IS ALPHA QUALITY SOFTWARE FOR RESEARCH PURPOSES ONLY. THIS IS NOT A PRODUCT. YOU ARE RESPONSIBLE FOR COMPLYING WITH LOCAL LAWS AND REGULATIONS. NO WARRANTY EXPRESSED OR IMPLIED.


About

A monthly updated and 100% open-sourced fork of openpilot with clean commits dedicated to serve the openpilot community! FrogPilot is shaped by user and developer contributions, emphasizing collaborative, community-driven development to provide a bleeding-edge openpilot experience for everyone!

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages