Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/netdcy/FlowVision
Waterfall-style image viewer for macOS, offering a smooth and immersive browsing experience.
https://github.com/netdcy/FlowVision
Last synced: 27 days ago
JSON representation
Waterfall-style image viewer for macOS, offering a smooth and immersive browsing experience.
- Host: GitHub
- URL: https://github.com/netdcy/FlowVision
- Owner: netdcy
- License: gpl-3.0
- Created: 2024-06-07T06:27:48.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-27T06:32:20.000Z (27 days ago)
- Last Synced: 2024-08-27T13:06:38.404Z (27 days ago)
- Language: Swift
- Homepage:
- Size: 4.7 MB
- Stars: 439
- Watchers: 3
- Forks: 13
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
FlowVision
Waterfall-style Image Viewer for macOS
[中文说明]
[](https://github.com/netdcy/FlowVision/releases/latest?color=blue "GitHub release") 
## Screenshots
### Light Mode
### Dark Mode
## Features:
- Adaptive layout mode, light/dark mode
- Convenient file management (similar to Finder)
- Right-click gestures, quickly find the previous/next folder with images/videos
- Performance optimizations for directories with a large number of images
- High-quality scaling (reduces moiré and other issues)
- Support for video thumbnails
- Recursive mode
## Installation and Usage
### System Requirements
- macOS 11.0 and Later
### Privacy and Security
- Open source
- No Internet connection
- Provide unsigned official builds
### Homebrew Install
Initial Installation
```
brew tap netdcy/flowvision
brew install flowvision --no-quarantine
```
Upgrade ('--no-quarantine' must be added when upgrading or reinstalling)
```
brew update
brew upgrade flowvision --no-quarantine
```
## Instructions:
### In Image View:
- Double-click to open/close the image.
- Hold down the right/left mouse button and scroll the wheel to zoom
- Hold down the middle mouse button and drag to move the window
- Long press the left mouse button to switch to 100% zoom
- Long press the right mouse button to fit the image to the view
### Right-Click Gestures:
- Right/Left: Switch to the next/previous folder with images/videos (logically equivalent to the next folder when sorting all folders on the disk)
- Up: Switch to the parent directory
- Down: Return to the previous directory
- Down-Right/Down-Left: Switch to the next/previous folder with images at the same level as the current folder
- Up-Right/Up-Left: Switch to the parent directory, then perform the Down-Right/Down-Left action
### Keyboard Shortcuts:
- W: Same as the right-click gesture Up
- A/D: Same as the right-click gesture Left/Right
- S: Same as the right-click gesture Down
## FAQ
**Q1: Why can't I open the application? I see a warning saying the app is not trusted.**
**A1:** This happens because the app is not notarized by Apple. To open it:
- Find the app in the Finder.
- Right-click the app file.
- Select "Open" from the menu.
- Click "Open" in the dialog that appears.
(https://support.apple.com/102445#openanyway)
**Q2: Why isn't the application notarized?**
**A2:** Notarizing an app requires an annual $100 fee to Apple. To keep the software free, we haven't notarized it. If you prefer, you can build the app yourself from the source code.
## Build
### Environment
Xcode 15.2+
### Libraries
- https://github.com/arthenica/ffmpeg-kit
- https://github.com/attaswift/BTree
- https://github.com/sindresorhus/Settings
### Steps
1. Clone the source code of the project and libraries.
2. 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:
```
sudo xattr -rd com.apple.quarantine ./ffmpeg-kit-full-gpl-6.0-macos-xcframework
```
3. Organize the directory structure as shown below:
```
├── FlowVision
│ ├── FlowVision.xcodeproj
│ └── FlowVision
│ └── Sources
├── ffmpeg-kit-build
│ └── bundle-apple-xcframework-macos
│ ├── ffmpegkit.xcframework
│ └── ...
├── BTree
│ ├── Package.swift
│ └── Sources
└── Settings
├── Package.swift
└── Sources
```
4. Open `FlowVision.xcodeproj` by Xcode, click 'Product' -> 'Build For' -> 'Profiling' in menu bar.
5. Then 'Product' -> 'Show Build Folder in Finder', and you will find the app is at `Products/Release/FlowVison.app`.
## License
This project is licensed under the GPL License. See the [LICENSE](https://github.com/netdcy/FlowVision/blob/main/LICENSE) file for the full license text.