https://github.com/OneFolderApp/OneFolder
File explorer made for pictures
https://github.com/OneFolderApp/OneFolder
calendar-view desktop face-detection filemanager object-detection photos
Last synced: 2 days ago
JSON representation
File explorer made for pictures
- Host: GitHub
- URL: https://github.com/OneFolderApp/OneFolder
- Owner: OneFolderApp
- License: gpl-3.0
- Created: 2023-10-21T17:43:36.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2025-09-21T17:08:36.000Z (21 days ago)
- Last Synced: 2025-09-21T19:06:54.374Z (21 days ago)
- Topics: calendar-view, desktop, face-detection, filemanager, object-detection, photos
- Language: TypeScript
- Homepage: https://onefolder.app
- Size: 44.5 MB
- Stars: 361
- Watchers: 12
- Forks: 17
- Open Issues: 46
-
Metadata Files:
- Readme: Docs/README.md
- License: LICENSE
Awesome Lists containing this project
README
- Website: https://onefolder.app/
- Roadmap: https://onefolder.canny.io/feedback
## What is it?
Desktop app to view your photos like you do in Google Photos or Apple Photos (e.g. Calendar, list, map, etc..) but locally and respecting metadata open standards (not creating a separate database to store that information*).
Sorting your files this way ensures you always own them, and can store them wathever you want: any cloud provider, a USB Drive or just your computer. They are just files!
## Features
- Watch folders (it does not copy them in a separate place, it watches and updates the folder in question)
- List and Grid View
- Edit metadata
Comming soon:
- Map View
- Calendar View
- Detect duplicates
- HEIC
## Do you want to help?
There is many ways people can help:
- Test new features
- feedback and suggestion on design
- Copy Writting and bloggin
- Detect new communities for growth
- Coding
If you are interested here is a form so we can reach out:
https://forms.gle/TpU1NxBQSreadki18
## Documentation
### Stack
This project is a fork from [Allusion](https://github.com/allusion-app/Allusion).
* [ElectronJS](https://www.electronjs.org/) - the framework for desktop development
* [ReactJS](https://react.dev/) - Front-end library
* [MobX](https://mobx.js.org/README.html) - State Manadgment
* [ExifTool](https://exiftool.org/) - Edit image metadata
* [Annotorious](https://annotorious.github.io/) - Face selection on images
* [TenserFlowJS](https://www.tensorflow.org/js) - Face detection
### Quick Start
You need to have [NodeJS](https://nodejs.org/en/download/) and a package manager such as [Yarn](https://yarnpkg.com/lang/en/docs/install/) installed.
Then run the following commands to get started:
1. Run `yarn install` to install or update all necessary dependencies.
2. Run `yarn dev` to build the project files to the `/build` directory. This will keep running to immediately build changed files when they are updated.
3. In a second terminal, run `yarn start` to start the application. Refresh the window (Ctrl/Cmd + R) after modifying a file to load the updated build files.
### Release Build
An installable executable can be built using `yarn package` for your platform in the `/dist` folder. The building is performed using the [electron-builder](https://www.electron.build/) package, and is configured by a section in the `package.json` file.
Builds are automatically published to Github Releases when a tag is created in GitHub.
## Star History
[](https://star-history.com/#OneFolderApp/OneFolder&Date)
### Releasing
When you want to create a new release, follow these steps:
1. Update the version in your project's `package.json` file (e.g. `1.2.3`)
2. Commit that change (`git commit -am v1.2.3`)
3. Tag your commit (`git tag v1.2.3`). Make sure your tag name's format is `v*.*.*`. Your workflow will use this tag to detect when to create a release
4. Push your changes to GitHub (`git push && git push --tags`)
After building successfully, the action will publish your release artifacts. By default, a new release draft will be created on GitHub with download links for your app. If you want to change this behavior, have a look at the [`electron-builder` docs](https://www.electron.build).