{"id":14363316,"url":"https://github.com/netdcy/FlowVision","last_synced_at":"2025-08-22T04:32:08.440Z","repository":{"id":243182542,"uuid":"811707899","full_name":"netdcy/FlowVision","owner":"netdcy","description":"Waterfall-style image viewer for macOS, offering a smooth and immersive browsing experience.","archived":false,"fork":false,"pushed_at":"2024-12-04T02:20:04.000Z","size":4961,"stargazers_count":562,"open_issues_count":10,"forks_count":16,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-04T03:18:33.474Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/netdcy.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}},"created_at":"2024-06-07T06:27:48.000Z","updated_at":"2024-12-04T02:09:09.000Z","dependencies_parsed_at":"2024-08-25T12:30:52.582Z","dependency_job_id":"14906bf2-4908-4698-af57-2a88cc0ff571","html_url":"https://github.com/netdcy/FlowVision","commit_stats":null,"previous_names":["netdcy/flowvision"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdcy%2FFlowVision","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdcy%2FFlowVision/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdcy%2FFlowVision/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/netdcy%2FFlowVision/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/netdcy","download_url":"https://codeload.github.com/netdcy/FlowVision/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230558147,"owners_count":18244994,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-27T17:01:02.476Z","updated_at":"2025-08-22T04:32:08.432Z","avatar_url":"https://github.com/netdcy.png","language":"Swift","readme":"\n\u003cp align=\"center\"\u003e\n\u003ch1 align=\"center\"\u003eFlowVision\u003c/h1\u003e\n\u003ch3 align=\"center\"\u003eWaterfall-style Image Viewer for macOS\u003cbr\u003e\u003cbr\u003e\u003ca href=\"./README_zh.md\"\u003e[中文说明]\u003c/a\u003e\u003c/h3\u003e \n\u003c/p\u003e\n\n[![](https://img.shields.io/github/release/netdcy/FlowVision.svg)](https://github.com/netdcy/FlowVision/releases/latest?color=blue \"GitHub release\") ![GitHub License](https://img.shields.io/github/license/netdcy/FlowVision?color=blue)\n\n## Screenshots\n\n### Light Mode\n![preview](https://netdcy.github.io/FlowVision/docs/preview_2.png)\n\n### Dark Mode\n![preview](https://netdcy.github.io/FlowVision/docs/preview_1.png)\n\n## Features:\n - Adaptive layout mode, light/dark mode\n - Convenient file management (similar to Finder)\n - Right-click gestures, quickly find the previous/next folder with images/videos\n - Performance optimizations for directories with a large number of images\n - High-quality scaling (reduces moiré and other issues)\n - Support for video playback\n - Support for HDR display\n - Recursive mode\n\n## Installation and Usage\n\n### System Requirements\n\n - macOS 11.0 or Later\n\n### Privacy and Security\n\n - Open source\n - No Internet connection\n\n### Homebrew Install\n\nInitial Installation\n```\nbrew install flowvision\n```\nUpgrade\n```\nbrew update\nbrew upgrade flowvision\n```\n\n## Instructions:\n### In Image View:\n - Double-click to open/close the image\n - Hold down the right/left mouse button and scroll the wheel to zoom\n - Hold down the middle mouse button and drag to move the window\n - Long press the left mouse button to switch to 100% zoom\n - Long press the right mouse button to fit the image to the view\n### Right-Click Gestures:\n - Right/Left: Switch to the next/previous folder with images/videos (logically equivalent to the next folder when sorting all folders on the disk)\n - Up: Switch to the parent directory\n - Down: Return to the previous directory\n - Up-Right: Switch to the next folder with images at the same level as the current folder\n - Down-Right: Close the tab/window\n### Keyboard Shortcuts:\n - W: Same as the right-click gesture Up\n - A/D: Same as the right-click gesture Left/Right\n - S: Same as the right-click gesture Down\n\n## Build\n\n### Environment\n\nXcode 15.2+\n\n### Libraries\n\n - https://github.com/arthenica/ffmpeg-kit\n - https://github.com/attaswift/BTree\n - https://github.com/sindresorhus/Settings\n\n### Steps\n\n1. Clone the source code of the project and libraries.\n2. For ffmpeg-kit, it need to be built to binary first. If you want to save time, you can directly download its pre-built binary, named like `ffmpeg-kit-full-gpl-6.0-macos-xcframework.zip` (not LTS version). Unzip it, then execute this in terminal to remove its quarantine attribute:\n\n    ```\n    sudo xattr -rd com.apple.quarantine ./ffmpeg-kit-full-gpl-6.0-macos-xcframework\n    ```\n    \n    (Due to the project being discontinued and copyright reasons, the prebuilt binaries have been removed. Here is a [backup](https://github.com/netdcy/ffmpeg-kit/releases/download/v6.0/ffmpeg-kit-full-gpl-6.0-macos-xcframework.zip) of original file.)\n\n3. Organize the directory structure as shown below:\n\n    ```\n    ├── FlowVision\n    │   ├── FlowVision.xcodeproj\n    │   └── FlowVision\n    │       └── Sources\n    ├── ffmpeg-kit-build\n    │   └── bundle-apple-xcframework-macos\n    │       ├── ffmpegkit.xcframework\n    │       └── ...\n    ├── BTree\n    │   ├── Package.swift\n    │   └── Sources\n    └── Settings\n        ├── Package.swift\n        └── Sources\n    ```\n\n4. Open `FlowVision.xcodeproj` by Xcode, click 'Product' -\u003e 'Build For' -\u003e 'Profiling' in menu bar.\n5. Then 'Product' -\u003e 'Show Build Folder in Finder', and you will find the app is at `Products/Release/FlowVison.app`.\n\n## Donate\n\nIf you found the project is helpful, feel free to buy me a coffee.\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://buymeacoffee.com/netdcyn)\n\n## License\n\nThis project is licensed under the GPL License. See the [LICENSE](https://github.com/netdcy/FlowVision/blob/main/LICENSE) file for the full license text.\n\n","funding_links":["https://buymeacoffee.com/netdcyn"],"categories":["Swift","Finder","Design and Product","Image Viewers","ユーティリティ"],"sub_categories":["Text","Other Tools","Password Managers","Finderツール"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetdcy%2FFlowVision","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnetdcy%2FFlowVision","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnetdcy%2FFlowVision/lists"}