Awesome
<picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/OneFolderApp/OneFolder/assets/27826950/e12e0f46-a1a8-484f-a443-b71d4a30d37f"> <img alt="Text changing depending on mode. Light: 'So light!' Dark: 'So dark!'" src="https://github.com/OneFolderApp/OneFolder/assets/27826950/b6291e54-daf9-42c1-8649-ec14532d79c7"> </picture>- 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.
- ElectronJS - the framework for desktop development
- ReactJS - Front-end library
- MobX - State Manadgment
- ExifTool - Edit image metadata
- Annotorious - Face selection on images
- TenserFlowJS - Face detection
Quick Start
You need to have NodeJS and a package manager such as Yarn installed. Then run the following commands to get started:
- Run
yarn install
to install or update all necessary dependencies. - 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. - 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 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
Releasing
When you want to create a new release, follow these steps:
- Update the version in your project's
package.json
file (e.g.1.2.3
) - Commit that change (
git commit -am v1.2.3
) - Tag your commit (
git tag v1.2.3
). Make sure your tag name's format isv*.*.*
. Your workflow will use this tag to detect when to create a release - 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.