Repository navigation
MSFS Compatibility: 1.39.12.0, 1.9.24.0.
MSFS Widget Version: 1.6.3
Release notes for 0.5.5.1
This update delivers a full code audit of the 0.5.5.0 release baseline alongside a number of new features and fixes. Key highlights include secure SHA-256 verified auto-updates, a new Monitor only flight type, smarter day/night switching with configurable switch timing and Day/Night profile pairing, improved VRAM+ and Start Max behaviour, Target FPS options saved per graphics mode, and the retirement of the old FPS Tolerance and FPS Cap auto methods.
Most of the many audit changes are defensive in nature: extra error handling and retries for rare situations (e.g. a file being locked or part written when it is read, a companion app like GPU-Z or OFXR closing mid-flight, or MSFS closing at an unusual moment), small fixes for edge cases that most users would never encounter, and tidying up of old code. No major issues were found, so in normal use you should notice little difference other than the new features and fixes listed below.
Please note two default behaviour changes: night now starts at about the end of civil twilight instead of about sunset, and night cloud reduction in VR now defaults to 1 level instead of following the 2D value. Both can be set back in the config files (details below).
Please review the readme here, which provides a detailed description of the app, installation, features and settings, before asking any questions or raising any issues about the app.
Executive Summary:
Secure Auto-Update & Installer Safety
- Auto-update now verifies the downloaded installer's SHA-256 against the digest published by GitHub before launching it, re-downloading on a mismatch and refusing the update if no digest is available. The installer also backs up your config files when upgrading from 0.5.5.0 or earlier, and reports unexpected errors with next steps instead of getting stuck.
- The SHA-256 installer verification was inspired by a fork by dankocrnkovic on GitHub, my thanks to them for offering their work.
Retired Auto Methods & Per-Mode Target FPS Options
- Retires the deprecated FPS Tolerance and FPS Cap auto methods with automatic profile conversion, removes all FPS Cap code, and saves the Target FPS option (Manual, Auto, Fixed) separately for each graphics mode in each profile. Also fixes the graphics mode not returning to FG / FSR FG after Lossless Scaling closes.
New Monitor Only Flight Type
- Adds a Monitor only entry to the Flight Type list in both Expert and Non-Expert modes: AutoFPS stops changing any sim settings and only monitors, with a simplified layout across the desktop app, in-game widget and web interface, and MSFS settings can be changed freely at any time.
Day/Night Switching & Night Profile Pairing
- Adds Day/Night profile pairing (Expert), a configurable day/night switch level with a sim-time hold that stops flip-flopping near the threshold, settling after manual sim time changes, a single global night cloud reduction setting with a separate VR value, and immediate night cloud reduction. Also fixes two night cloud reduction sequences that left clouds one level too high or never re-applied.
VRAM+ & Start Max Improvements
- Start Max is skipped when VRAM is already above the VRAM+ recovery threshold at session start and cancelled during the FPS settle if VRAM reaches the reduce threshold, with VRAM now monitored throughout the settle. Adds a live VRAM+ tooltip and a clearer limit symbol.
Flight Behaviour & Display Refinements
- Allows TLOD changes while taxiing up to 20 knots (but not during a takeoff roll), limits the Reduce label to 15 seconds after a reset, fixes default TLOD and OLOD not showing green (regression since 0.5.3.0), and makes profile auto-switch matching ignore capitalisation and unusual spacing.
In-Game Widget (v1.6.3) & Web Interface Fixes
- Fixes invisible checkbox ticks in light mode, adds the Monitor only layout, and fixes the Flight Type label and scrolling list, with all changes mirrored in the web interface.
Code Audit Hardening
- Applies defensive hardening across file handling, config saves, the power plan and process priority, companion app monitoring (GPU-Z, OFXR, VectorXR, LSFG, MSM), SimConnect handling, the local web server, update downloads and the installer, plus support for non-English Windows.
Licence & Documentation
- Introduces a new MSFS_AutoFPS licence (LICENSE.txt, now in the app folder) and restores and expands readme content, including the VRAM+ section.
Detailed Changes:
Secure Auto-Update & Installer Safety
- SHA-256 Installer Verification:
- Auto-update now compares the installer against the SHA-256 digest GitHub publishes for the release asset (
sha256:...) before launching it, ignoring case. - An installer already in your Downloads folder is verified in place. If it does not match, it is deleted, downloaded again and verified again.
- If the release has no digest for the installer, the update is refused and the file is left alone.
- The release data is fetched once more if it is missing.
- Silent updates only write a failure to the log. Otherwise an "Update Verification Failed" message is shown.
- The installer launch method and update URLs are unchanged.
- Auto-update now compares the installer against the SHA-256 digest GitHub publishes for the release asset (
- Installer Improvements:
- Config files (common, 2020 and 2024) are backed up to a
ConfigBackup_<version>folder before any config reset when upgrading from 0.5.5.0 or earlier. An existing backup folder is left alone, and a backup failure is logged and does not stop the installation. - An unexpected installer error now shows the reason and next steps instead of leaving the installer stuck.
- Uninstall now removes auto-start entries and the desktop link before deleting the app folder.
- File unblocking now handles paths containing apostrophes, and
-quickupdateis detected reliably.
- Config files (common, 2020 and 2024) are backed up to a
- Credit:
- The SHA-256 installer verification was based on an idea from a fork by dankocrnkovic on GitHub.
Retired Auto Methods & Per-Mode Target FPS Options
- FPS Tolerance and FPS Cap Deprecated:
- The Auto Method dropdown now lists only FPS Sensitivity and Auto TLOD, with the tooltip updated to match.
- Profiles on FPS Tolerance are switched to FPS Sensitivity automatically, with a message. Profiles on FPS Cap are converted automatically, also setting Fixed for every graphics mode of the profile, with a message. The old once-per-profile conversion prompt is removed.
- All FPS Cap and TLOD seeking code is removed, along with the
TLOD+ SeekandFPSCapstatus text. - Alt TLOD Top in Auto TLOD mode is reduced from 1000 to 100 ft, as 1000 was unnecessarily restrictive.
- Target FPS Option Saved per Graphics Mode:
- The Manual, Auto or Fixed option is now saved for each graphics mode in each profile. Existing settings are migrated from the profile's previous Auto and Fixed settings, which are kept in step so older versions still work if you roll back.
- The option dropdown applies to the mode shown in the Target FPS type dropdown. For a mode that is not active it is saved for later.
- Changing graphics mode outside a flight, or Man FG in a flight, loads the option for the new mode, with a reset when in a flight. Resetting a profile to defaults sets every mode to Manual.
- Graphics Mode Fixes:
- Fixed the graphics mode not returning to FG / FSR FG when Lossless Scaling is closed (also affects 0.5.5.0), as the FG type is now re-read from the MSFS config.
- The status line no longer stays on
LSFG Adapt 1XorMSM Adapt 1Xafter Lossless Scaling or MFG Super Motion closes. - The MSFS FG type is also re-read when leaving VR, so it goes straight to FG / FSR FG instead of briefly dropping to NFR.
- Man FG is now remembered when entering VR and restored when returning to 2D.
New Monitor Only Flight Type
- Monitor Only Mode:
- New Monitor only entry at the end of the Flight Type list, in both Expert and Non-Expert modes. AutoFPS stops changing any sim settings and only monitors (the status line shows Monitor Mode).
- On selecting it, the sim is first returned to your own default TLOD, OLOD, cloud quality and key settings.
- It is a global state remembered between sessions until another flight type is chosen. Choosing any other flight type leaves Monitor only, reloads that profile and does a full reset.
- It is not a profile and cannot be renamed. The active profile and all its settings are left untouched underneath.
- VR, sim rate and Night profile auto-switching are suspended while in Monitor only.
- The previous
MonitorModeconfig file method of enabling it is removed. The config key now only stores the selection.
- Simplified Layout:
- The Expert panel is hidden, and the General panel becomes a single line: On top, Dark, Log+ and Flight Type.
- Target FPS controls and the Expert checkbox are hidden. Reset is hidden too, except when no sim is running, where it still switches the MSFS 2020 / 2024 view.
- Log+ is forced on and locked (ticked and greyed out) while in Monitor only, and your saved Log+ setting is restored when you leave.
- The same layout changes apply in the in-game widget and web interface, where Target FPS, mode, Target, Expert and Log+ changes are ignored while in Monitor only.
- MSFS Settings Can Be Changed Freely:
- Changes to TLOD, OLOD (PC and VR) and cloud quality made in the MSFS options update the stored defaults and the readings in the app, widget and web interface immediately once saved, in or out of a flight session. Nothing is logged and nothing is restored or reapplied.
- Other flight types are unchanged: changes to managed settings during a flight session are still restored by AutoFPS and logged.
- Display Fixes:
- Fixed Clouds showing Low in Sim Values when the app was started with Monitor only already selected.
- Clouds now show green in Monitor only while they match the sim default (white if they ever differ), as TLOD and OLOD already did. The Reduce readout is no longer shown in Monitor only.
Day/Night Switching & Night Profile Pairing
- Day/Night Profile Pairing (Expert):
- Name two profiles the same, with one ending in " Night" (e.g. 'IFR' and 'IFR Night'), and AutoFPS uses the Night profile at night and the other profile during the day. The pairing is checked every tick in a flight, including at flight start, after a manual profile change and after a reset.
- Outside a flight either profile can be selected to edit its settings. In a flight, selecting the inactive profile of a pair switches straight back, so exit the flight first or temporarily rename the Night profile (e.g. 'IFR Nite') to edit it.
- A profile can have only one auto-switch partner: if either profile is also part of a VR pair, the VR pair takes priority and there is no Night pairing.
- Night mode is not used on the day profile of a pair (shown greyed out), and the Night profile can only use its cloud reduction (Clds), as TLOD halving is not needed on a dedicated night profile. Saved Night mode settings are kept and return if the profiles are unpaired.
- The switch carries current settings over to the new profile (no reset) when both profiles use the same auto method and Manual / Auto / Fixed option, and either it is turning to night, no settings reduction is active, or the new profile can recover any active reductions itself. Otherwise a full reset is done, as for VR and sim rate profile switching.
- Paired profiles show the ↔ marker in the Flight Type list, renaming a profile into a pair shows an auto-switch warning, and the status line and log show Day or Night.
- Profile Name Matching:
- VR, Night and sim rate auto-switch matching now ignores capitalisation and unusual spacing, e.g. 'IFR night', 'IFR vr', 'IFR 2x' and 'IFR Night' now pair. Profile names are cleaned on load and when renamed (non-breaking and zero-width characters, repeated spaces and leading or trailing spaces).
- Day/Night Switch Level and Hold:
- New
DayNightSwitchLevelkey inMSFS2020_AutoFPS.config/MSFS2024_AutoFPS.config(0 to 10, default 5), moving the switch to night (and back to day) earlier or later. Night is detected from the sim's automatic brightness, so timing follows the actual light level including latitude, season and cloud cover. - Level 0 is the previous behaviour (about sunrise / sunset), level 5 is about the end of civil twilight (new default) and level 10 is near total darkness.
- Default behaviour change: with the default level 5, night now starts at about the end of civil twilight instead of about sunset. This applies to all profiles, Non-Expert included, so Non-Expert night TLOD halving switches correspondingly later. Set
DayNightSwitchLevel=0for the previous timing. - After each day/night flip, further flips are held for 5 minutes of sim time (
DayNightSwitchHoldMinutes, 1 to 30, default 5), so a wobble around the threshold, e.g. flying in and out of broken cloud, no longer switches night settings on and off repeatedly. The hold runs faster at higher sim rates. - The hold ends early if brightness moves
DayNightSwitchHoldLevelsday/night levels (0 to 2, default 2) past the switch level, so a real change in light still gets through. 0 is a strict time lock. As a failsafe the hold also ends after twice its length in real time. Night profile pair switching follows the same hold.
- New
- Manual Sim Time Changes:
- A manual sim time change ends any day/night hold, and day/night is not decided until 3 seconds after the last change, so dragging the time slider no longer flips day/night (and night clouds) on every move.
- A flip decided right after a manual time change settles does not start a hold, as it is not a brightness wobble.
- Night Cloud Reduction:
- Night cloud reduction levels are now one global setting per sim config file (
NightCloudReduceLevelsGlobal, default 2, valid 1 to 3), used by all profiles including Non-Expert. A one-time migration uses your old per-profile values, which are left in the config file so older versions still work. - Default behaviour change: VR now has its own setting (
NightCloudReduceLevelsGlobalVR, 1 to 3, default 1), as VR cloud quality defaults are usually lower than 2D on the same system. Previously VR followed the 2D value. Set it to match the 2D value if preferred. - The Night mode dropdown Clds-X label shows the VR or 2D value for the graphics mode selected in Target, and updates when Target changes.
- Night cloud reduction and its daytime restore now apply straight away instead of after the FPS settle, on all profiles.
- Fixed night cloud reduction not reapplying after a night, day, night sequence, as Increase Cloud Quality could run before the night restore and block the next reduction.
- Fixed settings reduction recovery raising clouds one level above the night level (e.g. Medium to High) after a reduction cycle at night, which left clouds too high until day.
- Active (or disabled) settings reduction now takes priority over night cloud reduction in the Clouds / Reduce display, with the night cloud reduction shown in the tooltip.
- Night cloud reduction levels are now one global setting per sim config file (
VRAM+ & Start Max Improvements
- Start Max and VRAM:
- Start Max is skipped when VRAM at session start is above the VRAM+ recovery threshold (VRAM+ users with GPU-Z running), so the profile starts at Base Min TLOD with the normal FPS settle. A log line records it, and there is no change when VRAM+ is off or no GPU-Z reading is available.
- Start Max is cancelled automatically if VRAM reaches the VRAM+ reduce threshold while the FPS settle after it is still running. The Start Max extra is cleared and TLOD is dropped straight to Base Min, with a log line.
- VRAM is now monitored throughout the settle, where previously VRAM+ did not run during it and an overflow at the start could continue unchecked.
- Normal VRAM+ hold and reduce behaviour is unchanged.
- Tooltips and Symbols:
- The VRAM+ dropdown tooltip is now built from your live hold, reduce and recovery thresholds, and explains Max and Set, including that Auto Reduce Settings need not be ticked.
- The VRAM+ padlock beside TLOD in Sim Values is replaced by the limit symbol (⊤) already used when the sim's maximum TLOD is reached, as VRAM+ limits TLOD rather than locking it. The TLOD value has a tooltip explaining this while the symbol is shown.
Flight Behaviour & Display Refinements
- Taxiing and Takeoff:
- TLOD changes are now allowed while taxiing at up to 20 knots, but not during a takeoff roll. The critical flight phase now applies above 20 knots, or above 5 knots while accelerating (gaining 3.5 knots or more over 2 seconds), so normal taxiing is below it and takeoff rolls are above it.
- The same rule gates cloud quality increases and settings reduction recovery. On landing rollout, changes are allowed once ground speed drops below 20 knots, where before they waited until 5 knots. Behaviour in the air is unchanged.
- Reduce Label:
- The Reduce label now shows DynSet XX or Inactive for only 15 seconds, where before it showed it for the whole flight whenever settings reduction was enabled and nothing was being reduced. It then returns to the normal cloud state, unless settings reduction is active.
- The 15 seconds restarts at flight start, when MSFS dynamic settings are switched on or off in a flight (Expert), and on every full reset.
- Display Fixes:
- Fixed default TLOD and OLOD not showing green when they match the sim defaults, when MSFS is connected but no flight session has started and always in Monitor only (regression since 0.5.3.0).
- Fixed the Expert Settings label being clipped behind the Reset button after switching out of Expert mode with the title bar shown. The checkbox now stays "Expert" and a separate "Settings" word follows it in non-Expert mode, which also toggles Expert when clicked.
In-Game Widget (v1.6.3) & Web Interface Fixes
- Widget Fixes:
- Fixed checkbox ticks being invisible in light mode (e.g. Expert appeared unticked) (v1.6.1).
- Added the Monitor only layout (v1.6.2): Target FPS, Expert and Reset are hidden, Dark moves to the Flight Type line, and Log+ is locked on and dimmed.
- Fixed the Flight Type label still showing the Expert pairing marker (e.g. IFR ↔1) after unticking Expert (v1.6.3).
- The Flight Type list is now rebuilt each time it is opened with the selected item scrolled into view, scrolls with the mouse wheel even if the host swallows it, keeps scrolling inside the list, and has a wide visible scrollbar so it can also be clicked or dragged.
- All widget changes are mirrored in the browser version of the widget (
localhost:54321).
Code Audit Hardening
- Files and Configuration:
- Config files are now saved safely, so an interrupted save can no longer leave a damaged file, and a config file that is briefly locked is retried.
- MSFS config (
UserCfg.opt) reads that fail because MSFS is writing the file are logged once and retried instead of causing errors, and the watcher follows the active sim if it changes. - If restoring your MSFS config fails a format check, it is logged and the original file is restored instead.
- Alt TLOD Base values below 10 are now corrected in memory as well as in the config file, and stray unused VFR config entries are no longer created.
- Power Plan, Priority and Affinity:
- If AutoFPS exits uncleanly while it has switched your power plan, your original plan is restored at the next startup (only if the AutoFPS plan is still active).
- A quick off / on toggle of priority or affinity can no longer be undone by an earlier delayed change, and CPU affinity is now correct on systems with 64 or more logical processors.
- CPU headroom monitoring now works on non-English Windows.
- Companion Apps and Frame Generation:
- GPU-Z closing mid-flight is now detected (checked every 10 seconds once connected, retried every 30 seconds when unavailable), and a missing GPU Load sensor is logged once instead of being reported as connected.
- OFXR and VectorXR status files that stop updating for more than 4 seconds are treated as inactive rather than showing stale values.
- If the LSFG or MSM multiplier cannot be read, the current value is kept and the read is retried.
- Stability and Calculations:
- Errors in the main control loop and MSFS closing at an unusual moment, including during the compatibility test, are now handled and logged, with a normal shutdown instead of a crash or hang.
- SimConnect errors no longer cause excessive CPU use.
- Hysteresis decay is now 5 minutes on the ground and 2 minutes airborne, and Auto Target FPS has a minimum of 10.
- Night and day transitions no longer compound TLOD Min, Mountains and spike reductions during the transition, and the mid altitude reset TLOD uses the halved Max TLOD only at night.
- Web Server and Updates:
- The local web server now only accepts requests addressed to localhost / 127.0.0.1 from this server, rejecting others with 403 (logged once per session), and no longer lets widget polls pile up while the app is busy.
- Update downloads now time out instead of hanging, errors are always logged (with no popups for silent updates), and missing or invalid release data is logged instead of causing an error.
Licence & Documentation
- New Licence:
- A new MSFS_AutoFPS licence starts with this release (
LICENSE.txt, now included in the app folder). In summary: free personal use only; no redistribution or derivative works without written permission; no decompiling or reverse engineering; the original and previous authors must be credited; and the app name and icon are not licensed.
- A new MSFS_AutoFPS licence starts with this release (
- Readme:
- Reorganised the whole readme in increasing order of detail, from installation and quick start through to full technical reference, with troubleshooting steps (including the clean reinstall instructions) easier to find.
- Restored credits to the earlier authors, colours and symbols explanations, main controls, Auto Target FPS, graphics mode usage, install and uninstall notes, and additional FAQ entries, with full technical detail in collapsed drop-downs in a Detailed Reference section.
- Expanded the VRAM+ section (modes, hold, reduce and recovery behaviour, limit symbol, Start Max advice and skip rule) and corrected the thresholds config file reference to
MSFS2020_AutoFPS.config/MSFS2024_AutoFPS.config. - Documents updated:
LICENSE.txt,README.mdandREADME.pdf.