{"id":50980159,"url":"https://github.com/perez987/windowify-swiftui","last_synced_at":"2026-06-19T13:02:43.745Z","repository":{"id":357691470,"uuid":"1238137261","full_name":"perez987/Windowify-swiftui","owner":"perez987","description":"Open a picture as a configurable macOS-style window using a SwiftUI desktop app","archived":false,"fork":false,"pushed_at":"2026-05-13T21:28:06.000Z","size":7995,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-13T23:15:39.529Z","etag":null,"topics":["macos","screenshot","swiftui","windowify"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/perez987.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-13T21:08:32.000Z","updated_at":"2026-05-13T21:28:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/perez987/Windowify-swiftui","commit_stats":null,"previous_names":["perez987/windowify-swiftui"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/perez987/Windowify-swiftui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perez987%2FWindowify-swiftui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perez987%2FWindowify-swiftui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perez987%2FWindowify-swiftui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perez987%2FWindowify-swiftui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/perez987","download_url":"https://codeload.github.com/perez987/Windowify-swiftui/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perez987%2FWindowify-swiftui/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34532260,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-19T02:00:06.005Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["macos","screenshot","swiftui","windowify"],"created_at":"2026-06-19T13:02:42.676Z","updated_at":"2026-06-19T13:02:43.735Z","avatar_url":"https://github.com/perez987.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚥 Windowify-swiftui\n\n\u003e Open a picture as a configurable macOS-style window using a SwiftUI desktop app.\n\n![Main window](Images/Main-window.png)\n\n## Requirements\n\n- Swift 5\n- Xcode 15+\n- macOS 13+\n\n## How to use\n\n1. Build and run the app from Xcode or get it from the releases page. \n2. Load a PNG/JPG image by:\n   - dragging the file onto the main window, or\n   - using **File → Open…** (`⌘O`).\n3. Use the title field to set the window title (optional).\n4. Choose a window style from the three options:\n   - **Default options with titlebar** — standard window with close, minimise, and resize buttons.\n   - **Extended image with no titlebar** — borderless window where the image fills the entire frame.\n   - **Extended image with transparent titlebar** — standard window buttons with the image extending behind a transparent titlebar.\n5. Click **Update Preview** after changing the title or style to refresh the preview window.\n6. Press **⌘W** while the preview window is focused to close just that preview window.\n\n## Example\n\nUsing this picture as example:\n\n\u003cimg src=\"Images/Example.png\" width=\"500px\"\u003e\n\u003cbr\u003e\n\n**1.-** Default options with titlebar (close, minimise, and resize buttons)\n\n\u003cimg src=\"Images/Default-options.png\" width=\"570px\"\u003e\n\n**2.-** Adding a title to the text box\n\n\u003cimg src=\"Images/Default-options-custom-title.png\" width=\"570px\"\u003e\n\n**3.-** Extended image with no titlebar: image fills the entire window frame\n\n\u003cimg src=\"Images/Minimal-fullSizeContentView-titlebarAppearsTransparent.png\" width=\"570px\"\u003e\n\n**4.-** Extended image with transparent titlebar: standard buttons with the image extending behind a transparent titlebar\n\n\u003cimg src=\"Images/Default-options-fullSizeContentView-titlebarAppearsTransparent.png\" width=\"570px\"\u003e\n\n## Project structure\n\n- `Windowify-swiftui/App/` contains the app entry point, commands, and app delegate.\n- `Windowify-swiftui/Models/` contains shared model types such as `WindowAttributes`.\n- `Windowify-swiftui/ViewModels/` contains image loading and preview-window logic.\n- `Windowify-swiftui/Views/` contains the SwiftUI views split into smaller components.\n- `Windowify-swiftui/Languages/` contains the English and Spanish localizable files.\n\n---\n\n# ❖ Credits\n\n**Valerian Galliat** is the author of the [windowify](https://github.com/valeriangalliat/windowify) project, a command-line tool written in Swift. I really liked this project when I found it while searching for an app or tool that does exactly what windowify does.\n\nI've tried to port the original project (command-line tool) to a graphical application written in SwiftUI. The functionality is basically the same, but the goal has been to create a user-friendly interface that avoids entering commands in the Terminal.\n\n## Why?\n\nThe reason [Valerian Galliat](https://github.com/valeriangalliat) initially developed that was to fake a screenshot of a\nmacOS dialog with the native transparent shadow. See his\n[blog post](https://www.codejam.info/2023/04/macos-screenshot-dialog.html)\nfor details!\n\n---\n\n# ⌽ Xcode console messages\n\nI have not been able to completely remove messages from the Xcode console related to `com.apple.linkd.autoShortcut`. \n\n`com.apple.linkd.autoShortcut` is a macOS system XPC service used when the system tries to discover or register App Intents / App Shortcuts metadata for an app. When that service is unavailable, macOS prints connection errors like the ones above. They are usually harmless, but they add noise to the console.\n\nThese messages, however, are not seen in the macOS Console or if Windowify-swiftui is launched from Terminal with the command:\n\n`/Applications/Windowify.app/Contents/MacOS/Windowify`\n\nAny feedback will be very welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperez987%2Fwindowify-swiftui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperez987%2Fwindowify-swiftui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperez987%2Fwindowify-swiftui/lists"}