Sunnylink Wiki
Search and explore all Sunnypilot settings. Find the perfect configuration for your vehicle.
⚙️ All Settings
Browse and configure Sunnypilot settings.
📚 Model Library
Browse the complete library of 66+ driving models with descriptions, release dates, and community consensus.
📌 When to use: Find the perfect model for your driving style.
💡 Tip: Includes WMI Series, Dark Souls, Down to Ride, Tomb Raider, and Legacy models.
Adjust Camera Offset
Virtually shift camera's perspective to move model's center to Left (+ values) or Right (- values).
📌 When to use: Correct for camera mounting position or driver preference for lane position.
💡 Tip: Default 0.00. Adjust if you feel the car drives too far left or right in the lane.
Alpha Longitudinal
Uses Openpilot's end-to-end model for gas/brake control instead of stock ACC.
📌 When to use: Smoother following distance management than stock adaptive cruise.
💡 Tip: Required for Experimental Mode. Usually smoother than stock.
Always-on Driver Monitor
Keeps the driver facing camera active even when not engaged.
📌 When to use: Continuous attention tracking for added safety.
💡 Tip: Tracks your attention 24/7.
Auto Lane Change BSM Delay
Adds a safety delay if the Blind Spot Monitor (BSM) detects a car.
📌 When to use: Prevents lane change attempts when a vehicle is in your blind spot.
💡 Tip: Safety: Keep ON.
Auto Lane Change Timer
Sets the delay/confirmation method for automatic lane changes.
📌 When to use: Choose comfort level with automated lane changes.
💡 Tip: 'Nudge' requires wheel input; 'Instant' is automatic.
Blind Spot Detection
Shows an icon when a car is in your blind spot.
📌 When to use: Redundant BSM warning if you miss the mirror indicator.
💡 Tip: Extra safety layer if you don't look at mirrors (please look at mirrors).
Blinker Min Lateral Control Speed
The minimum speed at which the car will continue steering while the blinker is on.
📌 When to use: Prevents steering fight during slow turns at intersections.
💡 Tip: Prevents the wheel from fighting you during slow turns at intersections.
Blinker Pause Lateral Control
Pauses steering assistance immediately when the blinker is activated.
📌 When to use: For drivers who want complete manual control during lane changes.
💡 Tip: Preferred by drivers who want full control during lane changes.
Completed sunnylink Consent Version
Version of sunnylink consent form that was completed.
💡 Tip: Read-only. Shows which consent version you've agreed to.
copyparty Service
Runs a local file server on the device.
📌 When to use: Download drive videos over WiFi without SSH.
💡 Tip: Easy way to download drive videos via WiFi.
Create Backup
Backup current settings to device storage.
📌 When to use: Save your current configuration before updates or changes.
💡 Tip: Recommended before major updates or reinstalls.
Custom ACC Increments
Changes how much the speed changes when you press +/- on the wheel.
📌 When to use: Fine-tune speed adjustments - small taps for precision.
💡 Tip: Customize short press to ±1 and long press to ±5.
Device ID
Unique device identifier.
💡 Tip: Read-only. Used for device identification and support.
Disable Logging
Stops saving drive data to disk.
📌 When to use: Save storage space or for privacy.
⚠️ Warning: Saves space, but you lose evidence if an accident happens.
Disable Power Down
Keeps the device on forever.
📌 When to use: Testing or development where you need constant uptime.
⚠️ Warning: Will drain car battery.
Disable Updates
Stops automatic software updates.
📌 When to use: Lock in a known-good version.
💡 Tip: Use if you find a version you love and don't want it to change.
Disengage On Accelerator
Cancels openpilot when you touch the gas pedal.
📌 When to use: Keep OFF if you want to help accelerate without disengaging.
💡 Tip: Keep OFF if you want to be able to help the car accelerate without canceling steering.
Display Road Name
Shows the current street name on the UI.
📌 When to use: Situational awareness when navigating unfamiliar areas.
💡 Tip: Nice for situational awareness.
Display Rocket Fuel Bar
Show an indicator on the left side of the screen to display real-time vehicle acceleration and deceleration.
📌 When to use: Visualize how hard the system is accelerating or braking.
💡 Tip: Cool visual indicator showing throttle/brake intensity.
Driving Model
Select the AI driving model. Each model has unique driving characteristics.
📌 When to use: Choose a model that matches your driving style and road conditions.
💡 Tip: See the Model Library for detailed descriptions of all 66+ available models.
Driving Personality
Adjusts following distance and acceleration aggression.
📌 When to use: Customize driving feel - Relaxed for safety, Aggressive for keeping up with traffic.
💡 Tip: 'Standard' is the default. 'Aggressive' follows closer; 'Relaxed' leaves more gaps.
Dynamic Experimental Control
Automatically switches between Chill Mode (Highway) and Experimental Mode (City) based on driving context.
📌 When to use: Perfect for mixed commutes involving both freeways and city streets with traffic lights.
💡 Tip: Good for mixed driving, but switch to full Experimental if you need consistent behavior.
Enable ADB
Android Debug Bridge. Allows USB debugging.
📌 When to use: Developer access via USB cable.
💡 Tip: Developer use only.
Enable Custom Torque Tuning
Unlocks manual sliders for torque friction and lat-accel factors.
📌 When to use: For advanced users who want precise control over steering feel.
⚠️ Warning: Advanced Only. Don't touch unless you know your car's specific physics.
Enable SSH
Opens a secure shell for remote command-line access.
📌 When to use: Developer access for debugging and advanced configuration.
⚠️ Warning: Security Risk. Keep OFF unless you are coding.
Enable sunnylink Uploader
Uploads drive data to Sunnylink servers (currently infrastructure test only).
📌 When to use: Infrastructure testing. Uploaded data is currently not viewable by users.
💡 Tip: Currently for testing only. You cannot view your drives yet.
Enable sunnypilot
Master toggle for sunnypilot functionality.
📌 When to use: Quickly enable/disable all sunnypilot features.
⚠️ Warning: Disabling turns off all assisted driving features.
💡 Tip: Keep ON for normal operation.
Enforce Torque Control
Forces the car to use a torque-based controller for steering.
📌 When to use: For vehicles that respond better to direct torque commands vs angle commands.
💡 Tip: Usually kept OFF if using NNLC.
Experimental Mode
Enables stopping for traffic lights and stop signs using vision only.
📌 When to use: City driving where you encounter frequent traffic lights and stop signs.
⚠️ Warning: Be cautious at lights/signs. Requires Alpha Longitudinal.
💡 Tip: Must enable Alpha Longitudinal first.
Force Offroad Mode
Disables active driving features to unlock settings restricted while driving.
📌 When to use: Use when parked to change settings (Offroad), or for Valet mode.
💡 Tip: 'Offroad' means parked/not driving. 'Onroad' means driving.
Force Power Down
Force immediate shutdown of the device.
📌 When to use: Quickly power off when leaving the vehicle for extended periods.
💡 Tip: Use to immediately shut down instead of waiting for timeout.
Git Branch
Current git branch name.
💡 Tip: Read-only. Shows which branch you're running (e.g., 'dev', 'release').
Git Commit
Current software version hash.
💡 Tip: Read-only. Useful for bug reports.
Git Commit Date
Date of current commit.
💡 Tip: Read-only. Shows when current version was built.
GitHub Username
Connected GitHub account for development and updates.
📌 When to use: Link your GitHub account for custom fork management.
💡 Tip: Required for pushing custom changes or accessing private forks.
Green Light Alert
Chimes when a red light turns green.
📌 When to use: Alert distracted drivers to proceed when light changes.
💡 Tip: Very useful feature for distracted drivers.
GSM APN
Access Point Name for cellular data connection.
📌 When to use: Configure custom APN settings for your cellular carrier.
💡 Tip: Only modify if your carrier requires specific APN settings.
GSM Metered
Enables cellular data metering to track and limit data usage.
📌 When to use: Monitor data consumption when using mobile hotspot or cellular connection.
💡 Tip: Keep ON to track data usage on metered connections.
GSM Roaming
Allow cellular roaming when outside your carrier's network.
📌 When to use: Enable when traveling internationally and need connectivity.
⚠️ Warning: May incur roaming charges. Keep OFF unless traveling.
Has Accepted sunnypilot Terms
Indicates whether user has accepted sunnypilot terms of service.
💡 Tip: Read-only. Shows acceptance status.
Hyundai Longitudinal Tuning
Custom tuning for Hyundai/Kia acceleration profiles.
📌 When to use: Fixes the sluggish throttle response in Eco/Normal drive modes.
💡 Tip: 'Dynamic' can fix sluggish acceleration in Eco/Normal modes.
Lane Departure Warnings
Enable lane departure warning alerts.
📌 When to use: Get audible alerts when drifting out of lane without blinker.
💡 Tip: Useful for long highway drives to maintain alertness.
Lane Turn Desire
Forces the model to execute a turn when the blinker is active. Primarily used for 90-degree turns at intersections.
📌 When to use: Helps the car commit to sharp turns at lower speeds.
💡 Tip: Enable if lane changes feel sluggish or delayed.
Last AGNOS Power Monitor Shutdown
Timestamp of the last AGNOS power monitor shutdown event.
💡 Tip: Read-only. Shows when device last shut down due to power monitoring.
Lead Depart Alert
Chimes when the car in front starts moving.
📌 When to use: Prevents getting honked at in stop-and-go traffic.
💡 Tip: Good for stop-and-go traffic.
Less Restrict Settings for Self-Tune
Beta feature that allows the self-tuner to be more aggressive/forgiving when learning.
⚠️ Warning: Use with caution; allows faster learning but potentially wilder values.
Live Learning Steer Delay
Allow device to learn and adapt car's steering response time.
📌 When to use: Automatically compensates for vehicle-specific steering latency.
💡 Tip: Keep ON for optimal steering response.
Longitudinal Maneuver Mode
Specialized handling for low-speed maneuvers.
📌 When to use: Smoother stop-and-go traffic behavior.
💡 Tip: Helps with stop-and-go smoothness.
MADS Enabled
Modular Automated Driving System. Decouples steering from gas/brake, allowing steering to remain active during manual pedal input.
📌 When to use: Essential for highway driving where you want to manually coast or brake for traffic without losing lane keeping.
💡 Tip: Critical. This is the core feature of Sunnypilot. Keep ON.
MADS Main Cruise Allowed
Allows MADS to be active simultaneously with the main cruise control system.
💡 Tip: Keep ON.
MADS Steering Mode
Controls behavior when cruise is canceled. 'Remain Active' keeps steering engaged after braking.
📌 When to use: When you want to maintain lane centering during manual speed adjustments in traffic.
💡 Tip: Set to 'Remain Active' to keep lane centering while manually braking.
MADS Unified Engagement Mode
If enabled, engaging the main cruise control will also automatically engage MADS steering.
📌 When to use: Simplifies activation - one button press enables both speed control and steering.
💡 Tip: Convenient for one-button activation.
Manual Real-Time Tuning
Allows you to override torque values while driving.
⚠️ Warning: Debug Only. Dangerous for normal use.
Manual Software Delay
Manually adjusts the delay between command and action.
📌 When to use: Developer-only: Override learned steering delay.
⚠️ Warning: Don't touch. Leave on '0.00' unless instructed by devs.
Map Advisory Speed Limit
Respects yellow 'advisory' speed signs on curves/ramps.
📌 When to use: Automatically slow for highway off-ramp advisory speeds.
💡 Tip: Keep ON for safety on off-ramps.
Max Time Offroad
Maximum idle time (in seconds) before the device shuts down when offroad.
📌 When to use: Control how long the device stays on after parking.
💡 Tip: Default 1800 seconds (30 minutes). Increase if uploads aren't completing.
Neural Network Lateral Control
Replaces PID controller with a neural network for smoother, human-like steering.
📌 When to use: Fixes 'ping-pong' (oscillation) on straight roads common in Hyundai/Kia vehicles.
💡 Tip: Test carefully. If it ping-pongs, disable it and stick to stock.
Onroad Brightness
Sets brightness specifically when driving.
openpilot Version
Software version number.
💡 Tip: Read-only. Shows current installed version.
Plan Plus Controls
Adjust planplus model recentering strength. The higher this number, the more aggressively the model will recenter to lanecenter. Too high and it will ping-pong.
📌 When to use: Fine-tune how aggressively the model corrects back to center lane position.
💡 Tip: Default 1.0. Increase if car drifts too much, decrease if ping-ponging.
Power Off
Power off the device immediately.
📌 When to use: Safely shut down before disconnecting power.
💡 Tip: Use instead of unplugging for graceful shutdown.
Quick Boot
Attempts to boot the software faster by skipping checks.
📌 When to use: Faster startup for impatient users.
⚠️ Warning: Can cause instability. Keep OFF unless boot times are annoying.
Rainbow Mode
Easter egg: Makes the lane lines flash colors.
📌 When to use: Fun visual effect for showing off the system.
💡 Tip: Fun, but distracting.
Reboot
Restart the device immediately.
📌 When to use: Apply settings changes or fix software issues.
💡 Tip: Use after making significant configuration changes.
Record Front Lock
Prevents the device from deleting front camera footage.
📌 When to use: Preserve specific drive recordings for evidence or review.
💡 Tip: Useful if you need to save a specific drive for evidence.
Restore Version
Restore settings from a previous backup.
📌 When to use: Recover your configuration after a reset or new installation.
⚠️ Warning: This will overwrite current settings.
Route Count
Total number of recorded routes.
💡 Tip: Read-only. Shows how many drives have been recorded.
Screen Brightness
Sets the display backlight level.
💡 Tip: 'Auto' usually works best.
Self-Tune
Allows the car to self-calibrate steering parameters over time.
📌 When to use: Improves steering feel as the system learns your car's specific characteristics.
💡 Tip: Keep ON for better performance as you drive more.
Serial Number
Hardware serial number.
💡 Tip: Read-only. Used for device identification.
Show Advanced Controls
Unlocks hidden settings menus.
📌 When to use: Access all available configuration options.
💡 Tip: Keep ON to see everything in this list.
Show Turn Signals
Visualizes your blinkers on the device screen.
📌 When to use: Visual confirmation that blinker is active.
💡 Tip: Mostly cosmetic verification.
Smart Cruise Control - Map
Uses map data to slow down for curves.
📌 When to use: Backup for vision-based control when camera visibility is poor.
💡 Tip: Good backup, but Vision is usually faster/reactive.
Speed Limit Assist Mode
Determines if the car automatically adjusts speed to posted limits.
📌 When to use: Long road trips through towns with varying speed traps.
💡 Tip: 'Information' just shows the sign. 'Auto' changes your speed for you.
Speed Limit Offset Type
Choose between a fixed number (e.g., +5 mph) or a percentage (e.g., +10%).
📌 When to use: Fixed for consistent speeding; Percentage for proportional adjustments.
💡 Tip: Set to 'Fixed' for consistent speeding.
Speed Limit Offset Value
The actual amount to speed over the limit.
📌 When to use: Match local traffic flow (commonly 5-10 mph over in most US areas).
💡 Tip: Set to your comfort level (e.g., 5-10 mph over).
Speed Limit Source
Where the car gets speed data (Map Data, Car State, or Combined).
📌 When to use: Choose the most reliable source for your driving area.
💡 Tip: 'Map Data Priority' is usually most accurate in the US.
sunnylink Dongle ID
Unique sunnylink device identifier for cloud connectivity.
💡 Tip: Read-only. Your device's unique ID for sunnylink services.
Supported Car List
View all supported platforms in sunnypilot.
📌 When to use: Check if your vehicle is officially supported.
💡 Tip: Opens JSON list of all compatible vehicles.
Toyota: Enforce Factory Longitudinal Control
When enabled, sunnypilot will not take over control of gas and brakes. Factory Toyota longitudinal control will be used.
📌 When to use: Use Toyota's stock ACC instead of sunnypilot's longitudinal control.
💡 Tip: Enable if you prefer Toyota's stock adaptive cruise behavior.
Uninstall sunnypilot
Completely remove sunnypilot from the device.
📌 When to use: Clean uninstall before switching to a different fork.
⚠️ Warning: This will remove all sunnypilot data and settings.
Uptime Offroad
System idle time in seconds.
💡 Tip: Read-only. Shows how long device has been on while parked.
Uptime Onroad
Session driving time in seconds.
💡 Tip: Read-only. Shows total driving time for current session.
Vision-Based Turn Speed Control
Slows the car automatically for sharp curves based on camera vision.
📌 When to use: Driving on winding back roads where maintaining a constant 55mph would be dangerous.
💡 Tip: Very helpful on winding back roads.