Skip to content

Releases

FrogPaper 1.9.0 - Blush Light, new logo, honest Frog Dial

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 15 Nov 23:10

A light Christmas theme, the new badge everywhere, and frogs that stay away unless you ask.

Theme

  • New Christmas — Blush Light: the festive palette in daylight — blush snow panels, cranberry buttons, holly-green selections. Pink and red lead; green is the accent, not the base.
  • The festive theme is opt-in: both Christmas themes sit in the picker, and launching this build never switches your theme for you (the old one-time "edition default" that repainted existing installs is gone).
  • Every foreground clears WCAG AA on the surface it is painted on (worst pair 4.67:1).
  • Theme variants now inherit their family's logo, so the light Christmas theme shows the Christmas badge without a second asset.

Branding

  • The circular enamel-pin badge replaces the old frog-on-a-monitor logo: sidebar, tray, taskbar/window, exe icon, shortcuts, installer and uninstall entry, installer artwork, splash screen, website favicon and header mark.
  • Taskbar sizes (16–48px) use the frog's face inside a circle — the arched lettering turns to mush that small.
  • New tools/generate_brand_assets.py regenerates every asset from sidebar_logo.png.

Dropdowns

  • Type-to-filter box in every list; Enter takes the top match, Escape closes.
  • A 🕘 recently used row holds your last five picks per dropdown, across restarts.
  • The dice now uses a shuffled bag: every option once before any repeat (89 clicks used to hit 61 distinct subjects — now 89 of 89), continuing where it left off after a restart.
  • Lists repaired: shipped typo gone, duplicates and misfiled terms removed, genre words out of Mood, casing normalised (old spellings still resolve).
  • Colour: nonsense combinations are blocked (deep white, neon brown) while every retired word still parses, so older presets keep their palette.

Fixes

  • Frogs no longer appear with the Frog Dial off. Three leaks: a composition entry hardcoded "frog", the blank-subject pool excluded frogs but not toads, and the dice ignored the dial.
  • Mood no longer breaks the subject phrase — prompts opened with "Grand, frog" instead of "Epic frog" for every mood.
  • Hugging Face works again, and only where it still exists. It called api-inference.huggingface.co, a host that no longer resolves, so every request died before the token was read. It now uses the router, offers the only image model Hugging Face still serves (SD3 Medium), generates square, rounds sizes to a multiple of 16, retries a dropped connection, and explains permission problems instead of blaming the plan. tools/verify_hf_token.py checks a token without launching the app.
  • Progress bars follow the theme — sv_ttk was repainting them Windows blue; they now use a FrogPaper style and pick up the theme accent.
  • No more name.png.png: filenames keep one extension, and the 37 files already doubled were renamed with every stored path updated.
  • Deleting an image keeps its evidence; every generated image is logged with its source.

Under the hood

  • New image_events table, tools/option_report.py (uses / favourites / deletes / wallpapers per option) and tools/option_audit.py (list hygiene gate).
  • Keyword expansion results are cached to cache/expansions.json: a word you have used before expands instantly and never loads the language model again (measured: 14s cold, 0.02s warm).
  • Hugging Face goes through the router the service actually uses now, with its credit-backed endpoint for FLUX; the old host no longer exists.
  • 755 tests, including golden prompt snapshots and a regression test for each bug above.

Heads-up

  • Windows caches taskbar icons per executable path: rebuild the exe/installer to see the new icon, and unpin/repin if it lingers.
  • The installer is unsigned, so SmartScreen may warn. Choose More info → Run anyway.
  • Your wallpapers, tags, favourites and API keys in %LOCALAPPDATA%\FrogPaper are untouched.

Install: FrogPaper-Setup-1.9.0.exe
SHA-256: 6DB19533821D85980225B4983E2A85CE52E8A03EDA1763BCC03777DBE7E187F5

FrogPaper v1.8.0

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 04 Nov 03:19

Styles that finally look like their names, a smarter Ctrl+N, and the Halloween costume retired.

Styles — rebuilt

  • Oil Painting, Watercolour, Gouache, Impressionist and 3D Render now use a Kuwahara renderer (flat painted regions with preserved edges) instead of a blur.
  • Line Art no longer floods the page with black. Comic Book, Manga and Pop Art use real colour quantisation with clean black keylines.
  • Fixed the filters that were outright broken: Art Deco (drew stripes), Edge Enhance (rendered near-black), Noir B&W (flat grey), 3D Render (blue speckle), Pop Art (pale noise).
  • Sketch Pencil is its own graphite pass. Posterize uses 6-colour k-means. Cyberpunk Neon is a real magenta/cyan edge glow.

Generation

  • Ctrl+N chooses: a random prompt when nothing changed, your built prompt right after an edit.
  • Cancel now stops the transfer and never leaves a partial PNG behind.
  • Pollinations 401/402/403/404 explain themselves — 402 means the model is out of credits.

Interface

  • 26 text-overlay fonts (was 14), alphabetical, with a scrollbar.
  • Mouse wheel fixed for touchpads and high-resolution wheels.
  • Footer links renamed: Downloads & Updates, plus a Facebook Page link.
  • Rounder corners, and the tray menu shows the running version.
  • Settings > Help now has one Version History list instead of three overlapping ones.

Fixes

  • A config.json that cannot be read is never overwritten — locked, corrupt, or saved with a UTF-8 BOM used to wipe every API key.
  • Changing Sync Scope no longer deletes the cloud copies of images outside the new scope.
  • Gallery thumbnails no longer blank out past 200 images.
  • Ctrl+N and the tray's Generate item now call a method that exists.

Heads-up

  • Halloween Edition branding is retired: About shows a plain version and fresh installs start with a blank startup subject. The theme and its popup sound are still available.
  • The installer is unsigned, so SmartScreen may warn. Choose More info → Run anyway.
  • Your wallpapers, tags, favourites and API keys live in %LOCALAPPDATA%\FrogPaper and are untouched.

Install: FrogPaper-Setup-1.8.0.exe (69.3 MB)
SHA-256: E646264636CCA739CB7FA6B22271C5392927F29F7EEDC7180DDB99CDADF569AA

v1.7.12 - Update-check fix + splash

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 30 Oct 18:26

FrogPaper 1.7.12 — Update-check fix

This release fixes the in-app update checker and keeps the splash screen and faster onedir startup from 1.7.11.

Fixed

  • Check for Updates no longer crashes. 1.7.11 referenced the installer URL before assigning it whenever a release had an .exe asset, which could raise UnboundLocalError and leave the update check broken. The updater now initializes its fallback URL and picks the Setup asset — or the first .exe asset if the release uses the older FrogPaper-<version>.exe name.
  • Install Update opens the release page again. 1.7.11 accidentally re-enabled the old in-app auto-install helper. 1.7.12 restores the v1.7.7+ behavior: FrogPaper opens the release page, and you run the setup file yourself. The installer still closes a running FrogPaper cleanly and upgrades in place.
  • Older release asset names work. Releases published without Setup in the filename are found correctly.

Kept from 1.7.11

  • Splash screen while FrogPaper starts.
  • Onedir Windows build — no per-launch unpack of a ~100 MB single file.
  • The 10-minute slideshow interval fix.
  • Your wallpapers, favourites, settings and API keys stay in %LOCALAPPDATA%\FrogPaper and carry over.

Installer

FrogPaper-Setup-1.7.12.exe (72 MB)

SHA-256: 193f966adda609fd3e9ee0a6945d5b6921000553ef1eac06b5c5f2b711fedae2

Windows may show an “unknown publisher” SmartScreen prompt because the installer is not code-signed. Choose More info → Run anyway if you trust the download.

v1.7.11 - Splash Screen and faster load time.

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 30 Oct 03:38

Heads-up: This build contains a broken in-app update checker. Please download v1.7.12 instead - it fixes the update check and keeps the splash screen and onedir startup from this release.

v1.7.11 introduced the splash screen and the onedir Windows build.

v1.7.10 — Clearer update errors

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 25 Oct 19:21

FrogPaper v1.7.10

Clearer update errors

The manual Check for Updates button now tells you why a check failed instead of the generic “Couldn’t reach GitHub” message. Depending on the failure, it will say:

  • the connection timed out
  • DNS lookup for api.github.com failed
  • a TLS/certificate error occurred
  • GitHub’s unauthenticated API rate limit is exhausted, including the local reset time
  • GitHub returned a 404 or a 5xx server error
  • GitHub refused the request with another HTTP status

The failure dialog also has an Open Release Page button, so you can check or download manually without leaving FrogPaper.

No other changes. Your settings, gallery and API keys are untouched.

Upgrading

Run FrogPaper-1.7.10.exe. The installer closes a running FrogPaper, installs the new build, and keeps your data in %LOCALAPPDATA%\FrogPaper.

The app is unsigned, so Windows SmartScreen may ask you to confirm the first run.

Checksums

FrogPaper-1.7.10.exe  SHA256  B649DD5245EBDD417F9BBDECBE4C20B43983F325388F8F03555C55DD699DC6E5

Verify with: certutil -hashfile FrogPaper-1.7.10.exe SHA256

v1.7.9 — Slideshow countdown shows seconds

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 25 Oct 18:43

FrogPaper v1.7.9

Slideshow countdown now shows seconds

Long intervals previously showed only hours and minutes, so the label sat on 11h 59m for a full minute and looked frozen.

The countdown now ticks visibly:

  • 11h 59m 42s
  • 24h 00m 00s
  • 3d 02h 05m 12s

The progress bar still fills continuously. Nothing else changes; your settings and data are untouched.

Upgrading

Run FrogPaper-1.7.9.exe. The installer closes a running FrogPaper, installs the new build, and keeps your data in %LOCALAPPDATA%\FrogPaper.

The app is unsigned, so Windows SmartScreen may ask you to confirm the first run.

Checksums

FrogPaper-1.7.9.exe  SHA256  3176ABAD74CFC25B3F13E0C1182FE5D51F8068C17ABC494ED5BAC9432644752B

Verify with: certutil -hashfile FrogPaper-1.7.9.exe SHA256

v1.7.8 — Check for Updates + slideshow timer fixes

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 25 Oct 18:28

FrogPaper v1.7.8

New: Check for Updates button

  • Settings → Help → Updates now has a Check for Updates button.
  • It checks GitHub on demand, shows Checking for updates…, and reports one of:
    • a newer release is available,
    • you are already on the latest version,
    • GitHub could not be reached.
  • Manual checks ignore a previous “Skip This Version”, so you can always re-check.
  • When an update exists, Install Update opens the release page in your browser; FrogPaper does not download or run installers by itself.

Slideshow timer fixes

Three separate issues could make wallpapers change sooner than the selected interval:

  • Startup no longer changes the wallpaper one second after launch. The first change now waits for the full configured interval. Opening or restarting the app no longer rotates the wallpaper immediately.
  • Changing the interval while the slideshow is running now reschedules the live timer. Previously a pending 60-minute change would still fire once after switching to 12 hours.
  • Fresh installs now default to slideshow off / 60 minutes. The shipped template previously enabled the slideshow at a 1-minute interval.

Existing settings are preserved.

Upgrading

Run FrogPaper-1.7.8.exe. The installer closes a running FrogPaper, installs the new build, and keeps your data in %LOCALAPPDATA%\FrogPaper.

The app is unsigned, so Windows SmartScreen may ask you to confirm the first run.

Checksums

FrogPaper-1.7.8.exe  SHA256  AE9D3540D6F19190BA222344F5D26F71E084EB2831808088AD657A65584C2E38

Verify with: certutil -hashfile FrogPaper-1.7.8.exe SHA256

v1.7.7 — Update flow + installer force-close + website link

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 24 Oct 23:52

What's new

  • Update flow: the in-app auto-installer is gone. "Install Update" now opens the release page in your browser; download and run the setup yourself. The old hand-off (helper batch waiting for FrogPaper's PID, then starting setup) could stall behind a running app — users saw a console window and nothing installed.
  • Bottom bar: added a "Link To Website" clickable label next to the Sync button — opens https://sunnyskyess420.github.io/frogpaper-website/ for manual update checks.
  • Installer: force-closes the running app on install (CloseApplications=force) and uses restartreplace so the new build replaces the old one cleanly. Verified: silent install with FrogPaper running returns exit code 0 (was exit 5 / "DeleteFile failed; code 5. Access is denied" before).
  • Build: build_frogpaper_exe.bat no longer deletes dist\ — user data beside the EXE is preserved across rebuilds.
  • User data: %LOCALAPPDATA%\FrogPaper (with one-time copy from beside the EXE on first launch).

Checksums

FrogPaper-Setup-1.7.7.exe  SHA256  520E60DC103904F1E46764E723256E5048A1AF78B0070ABBA3A0F407E8022FAD

Verify with: certutil -hashfile FrogPaper-Setup-1.7.7.exe SHA256

v1.7.6 — security, repaired style filters, your data outside the program folder

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 24 Oct 21:23
31dc3a1

FrogPaper v1.7.6

A security release with one new feature, a repaired style engine, and a
change to where your files live — the last one matters most.

Security

  • Pillow 13.0.0 — closes the 2026-10 advisory wave that affects earlier
    Pillow releases (including CVE-2026-96639, CVE-2026-112403 and
    CVE-2026-112406).
  • NLTK 3.10.4 — the first release that patches GHSA-8mgp-746c-j5xp.
  • The Windows EXE is now built from a clean environment that installs
    requirements.txt exactly, so these pins are what actually ships rather
    than whatever happened to be installed on the build machine.

Style filters work again

Applying a style (Comic Book, Watercolour, Oil Painting and the other 24)
silently did nothing, because the bundled OpenCV was compiled against
NumPy 1.x and cannot load under NumPy 2. OpenCV is now pinned to a NumPy 2
compatible build, and every filter is verified on Windows before a release.

If the image engine ever fails to load again, FrogPaper now says so in a
dialog instead of failing silently.

New: slideshow intervals up to 24 hours

The Settings → Slideshow picker is a preset list instead of a 1-60 minute
slider: 1, 5, 10, 15 and 30 minutes, then 1, 2, 3, 4, 6, 8, 12 and 24 hours.
Intervals are still stored in minutes, so existing settings carry over
unchanged, and a hand-edited value that is not on the list is kept and
shown. Long waits render as 24h 00m in the status bar.

Your data is safer

FrogPaper used to keep everything — config.json with your API keys,
wallpapers/, tags, favourites and logs — in the same folder as
FrogPaper.exe. Rebuilding or replacing that folder deleted all of it.

It now lives in %LOCALAPPDATA%\FrogPaper. On first launch, anything an
older version left beside the EXE is copied into the new location.
Nothing is moved, nothing is overwritten, and the old folder is left
untouched, so the first launch of v1.7.6 is safe even if you upgrade and
downgrade.

Two related fixes on the build side:

  • The packaging script no longer deletes the output folder, only the
    previous executable.
  • Uninstalling no longer deletes your wallpapers, favourites or styled
    images.

Upgrading from v1.7.5

  • Your keys, settings, gallery, tags and favourites appear automatically.
    The first launch may pause for a few seconds while they are copied.
  • Your data folder is now %LOCALAPPDATA%\FrogPaper. If you want to make a
    manual backup, copy that one folder.
  • Running from source (python main.py) is unchanged: data stays in the
    project folder.
  • The app is still unsigned, so Windows SmartScreen may ask you to confirm
    the first run.

Checksums

FrogPaper-Setup-1.7.6.exe  SHA256  bd119d7c2f9466f48248f15a05e364f1c57601e10fc7685d19181ad064833916

Verify with: certutil -hashfile FrogPaper-Setup-1.7.6.exe SHA256

v1.7.5 - Styles and Text Overlay Restored

Choose a tag to compare

@sunnyskyess420 sunnyskyess420 released this 20 Oct 00:49

Styles and text overlay are back

Two features were failing with misleading errors — "the image file may be corrupted" — when the real problem was a library mismatch inside the build.

What was wrong: the app bundled OpenCV 4.8, compiled against NumPy 1.x, alongside NumPy 2.5. Importing cv2 raised _ARRAY_API not found, so every style failed with name 'cv2' is not defined. And because style_transfer.py imported OpenCV and PIL in one block, that same failure also set Image = None — which is why text overlay died with 'NoneType' object has no attribute 'open' and blamed your file.

Fixed:

  • OpenCV upgraded to 4.14, built for NumPy 2. import cv2 now succeeds.
  • OpenCV and PIL are probed separately. Text overlay only needs PIL, so a future OpenCV problem can never take it down again.
  • Style filters and text overlay were both exercised on a test image before this build: comic_book produced a 28 KB output, text overlay a 12 KB output.

Under the Hood:

  • style_transfer.py: CV2_AVAILABLE / PIL_AVAILABLE flags; STYLE_TRANSFER_AVAILABLE requires both for filters.
  • Build environment: opencv-python 4.8.1.78 → 4.14.0.94.
  • 472 tests passing (3 logging tests need pytest -s in this shell due to a stdin-capture quirk); ruff clean.

The installer is unsigned, so Windows SmartScreen may show a warning. Choose "More info" → "Run anyway".