Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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: about 2 months 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 (8 months ago)
Default Branch: main
Last Pushed: 2024-12-04T02:20:04.000Z (2 months ago)
Last Synced: 2024-12-04T03:18:33.474Z (2 months ago)
Language: Swift
Homepage:
Size: 4.73 MB
Stars: 562
Watchers: 2
Forks: 16
Open Issues: 10
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-free-apps - FlowVision - Waterfall-style image viewer. 🍎 🟢 (Image Viewers / Password Managers)

README

FlowVision

Waterfall-style Image Viewer for macOS

[中文说明]

[![](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)

## Screenshots

### Light Mode
![preview](https://netdcy.github.io/FlowVision/docs/preview_2.png)

### Dark Mode
![preview](https://netdcy.github.io/FlowVision/docs/preview_1.png)

## 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
- Up-Right/Up-Left: Switch to the next/previous folder with images at the same level as the current folder
- Down-Right: Close the tab/window
### 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. Please follow the instructions provided in [Apple support article](https://support.apple.com/102445#openanyway) to open the app.

**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.