Skip to content

New Feature: you can choose a folder of photos as your background picture,it will change by time.#633

Open
Josh050608 wants to merge 2 commits intognachman:masterfrom
Josh050608:background-folder
Open

New Feature: you can choose a folder of photos as your background picture,it will change by time.#633
Josh050608 wants to merge 2 commits intognachman:masterfrom
Josh050608:background-folder

Conversation

@Josh050608
Copy link
Copy Markdown

Summary

This change adds a new background image source mode for profiles: Folder Rotation.

In Settings > Profiles > Window > Background, profiles can now choose between:

  • Single Image
  • Folder Rotation

When Folder Rotation is selected, the profile can store:

  • a folder path
  • a rotation interval in seconds

At runtime, sessions using the same profile share the same rotated background image.

What Changed

  • Added new profile keys for:
    • background image source mode
    • background image folder location
    • background image folder interval
  • Extended the Profiles > Window > Background UI with:
    • Source
    • Folder
    • Interval (seconds)
  • Added a profile-level background image rotation manager
  • Updated PTYSession to resolve background images through the rotation manager when folder rotation is enabled
  • Kept existing single-image behavior unchanged

Behavior

  • Rotates images from the configured folder at the configured interval
  • Uses a shared runtime state per profile, so windows/panes with the same profile stay in sync
  • Re-scans the folder on each tick so added/removed images are picked up automatically
  • Continues polling even if the folder is temporarily empty, so rotation resumes automatically when images appear again

Manual Testing

Tested manually with a Development build:

  • Verified Single Image still works as before
  • Verified Folder Rotation settings save and reload correctly
  • Verified folder preview appears in the settings UI
  • Verified images rotate at the configured interval
  • Verified multiple windows/panes using the same profile stay in sync
  • Verified newly opened windows using the same profile inherit the current rotated image
  • Verified changing the folder or interval updates existing sessions
  • Verified an empty folder does not crash and resumes when images are added later

Demo video

output.mp4

@Josh050608 Josh050608 changed the title Background folder New Feature: you can choose a folder of photos as your background picture,it will change by time. Mar 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant