Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sprout2000/leafview
Minimalist image viewer based on Leaflet.js and Electron.
https://github.com/sprout2000/leafview
image-viewer macos pan wheelzoom
Last synced: 4 days ago
JSON representation
Minimalist image viewer based on Leaflet.js and Electron.
- Host: GitHub
- URL: https://github.com/sprout2000/leafview
- Owner: sprout2000
- License: mit
- Created: 2020-03-22T08:45:22.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-02-08T06:22:50.000Z (12 days ago)
- Last Synced: 2025-02-08T16:09:05.422Z (11 days ago)
- Topics: image-viewer, macos, pan, wheelzoom
- Language: TypeScript
- Homepage:
- Size: 45.1 MB
- Stars: 190
- Watchers: 7
- Forks: 21
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# 
LeafView
[](https://github.com/sprout2000/leafview/blob/master/LICENSE.md)
Minimalist image viewer based on [Leaflet.js](https://leafletjs.com/) and [Electron](https://www.electronjs.org/).
## :thumbsup: Features
- Pan & Wheel Zoom
- Browse the images in a folder
- Grid view
- Available in [17 languages](#globe_with_meridians-supported-languages)
- Auto update _(only on macOS)_
## :inbox_tray: Download
### :computer: macOS & GNU/Linux
You can download the latest version of _LeafView_ from the releases page here:
[https://github.com/sprout2000/leafview/releases](https://github.com/sprout2000/leafview/releases)
### :desktop_computer: Windows
You can get _(or upgrade to)_ the latest version of _LeafView_ via [winget](https://github.com/microsoft/winget-cli):
```sh
winget install sprout2000.LeafView
```
## :green_book: Usage
### :keyboard: Keyboard Shortcuts
| Key | Function |
| :---------------------------------------------------------------------------: | :--------------------------------- |
| J, Ctrl+N, CmdOrCtrl+→ | Next Image |
| K, Ctrl+P, CmdOrCtrl+← | Previous Image |
| + | Zoom In |
| - | Zoom Out |
| 0 | Reset Zoom |
| ← ↑ ↓ → | Pan |
| Fn+Delete or Del | Move to Trash |
| H, Ctrl+G | Toggle Grid View |
| Ctrl+Shift+T | Toggle Menubar _(Windows / Linux)_ |
### :computer_mouse: Mouse Operations
| Mouse | Function |
| :----------: | :----------------------------------- |
| Drag | Pan |
| Wheel | Zoom in/out |
| Double click | Reset zoom |
| Right click | Show the context menu when available |
## :globe_with_meridians: Supported Languages
| Language | Code |
| :------------ | :-----: |
| اللغة العربية | `ar` |
| Čeština | `cs` |
| Deutsch | `de` |
| English | `en` |
| Español | `es` |
| Français | `fr` |
| हिंदी | `hi` |
| Magyar | `hu` |
| Italiano | `it` |
| 日本語 | `ja` |
| Polski | `pl` |
| Português | `pt` |
| Русский | `ru` |
| Türkçe | `tr` |
| Українська | `uk` |
| 简体中文 | `zh_CN` |
| 繁体中文 | `zh_TW` |
## :beers: Contributing
You can easily contribute to this repository by providing translation files.
1. Create `{your_LANG}.json` in `src/locales`.
```diff
src
├── @types
├── createMenu.ts
├── locales
+ │ ├── cs.json
│ ├── en.json
│ └── ja.json
├── main.ts
├── preload.ts
├── setLocales.ts
└── web
```
2. And then please send a [pull request](https://github.com/sprout2000/leafview/pulls) to this repository.
## :tada: Contributors
Thanks go to these wonderful people :slightly_smiling_face::
## :copyright: Copyright
Copyright (c) 2020-2025 sprout2000