ente/README.md

60 lines
1.7 KiB
Markdown
Raw Normal View History

2021-04-02 09:15:11 +00:00
# bhari-frame (heavy-frame)
2021-03-27 12:35:04 +00:00
2021-08-22 19:06:02 +00:00
Desktop app for [ente.io](https://ente.io) build with [electron](https://electronjs.org) and loads of ❤️.
2021-03-27 12:35:04 +00:00
2021-08-22 19:06:02 +00:00
## Disclaimer
We are aware that electron is a sub-optimal choice for building desktop applications.
The goal of this app was to
1. provide a stable environment for customers to back up large amounts of data reliably
2. export uploaded data from our servers to their local hard drives.
2022-09-08 05:23:12 +00:00
2021-08-22 19:06:02 +00:00
Electron was the best way to reuse our battle tested code from [bada-frame](https://github.com/ente-io/bada-frame) that powers [web.ente.io](https://web.ente.io).
As an archival solution built by a small team, we are hopeful that this project will help us keep our stack lean, while ensuring a painfree life for our customers.
If you are running into issues with this app, please drop a mail to [support@ente.io](mailto:support@ente.io) and we'll be very happy to help.
## Download
2022-07-08 02:38:11 +00:00
2021-08-22 19:06:02 +00:00
- [Latest Release](https://github.com/ente-io/bhari-frame/releases/latest)
2022-07-08 02:38:11 +00:00
*User contributed ports*
- [AUR](https://aur.archlinux.org/packages/ente-desktop-appimage):
`yay -S ente-desktop-appimage`
2021-08-22 19:06:02 +00:00
2022-09-08 05:23:12 +00:00
## Building from source
2021-04-02 09:15:11 +00:00
2022-09-08 05:23:12 +00:00
You'll need to have node installed on your machine. e.g. on macOS you can do
`brew install node`. After that, you can run the following commands to fetch and
build from source.
2021-04-02 09:15:11 +00:00
```bash
# Clone this repository
git clone https://github.com/ente-io/bhari-frame
2022-09-08 05:23:12 +00:00
2021-04-02 09:15:11 +00:00
# Go into the repository
cd bhari-frame
2022-09-08 05:23:12 +00:00
# Clone submodules (recursively)
git submodule update --init --recursive
# Install packages
yarn
2021-04-02 09:15:11 +00:00
# Run the app
2022-09-08 05:23:12 +00:00
yarn start
2021-04-02 09:15:11 +00:00
```
2021-08-22 19:06:02 +00:00
### Re-compile automatically
2021-04-02 09:15:11 +00:00
2022-09-08 05:23:12 +00:00
To recompile automatically and to allow using
[electron-reload](https://github.com/yan-foto/electron-reload), run this in a
separate terminal:
2021-03-27 12:35:04 +00:00
```bash
2022-09-08 05:23:12 +00:00
yarn watch
2021-03-27 12:35:04 +00:00
```