ente/cli
2024-03-14 16:20:47 +05:30
..
cmd
docs
internal
pkg
utils
.gitattributes [cli] Mark docs/generated as generated for Github 2024-03-14 16:20:47 +05:30
.gitignore
config.yaml.example
docker-compose.yml
Dockerfile
Dockerfile-x86
go.mod
go.sum
main.go
README.md
release.sh

Ente CLI

The Ente CLI is a Command Line Utility for exporting data from Ente. It also does a few more things, for example, you can use it to decrypting the export from Ente Auth.

Install

The easiest way is to download a pre-built binary from the GitHub releases.

You can also build these binaries yourself

./release.sh

Or you can build from source

 go build -o "bin/ente" main.go

The generated binaries are standalone, static binaries with no dependencies. You can run them directly, or put them somewhere in your PATH.

There is also an option to use Docker.

Usage

Run the help command to see all available commands.

ente --help

Accounts

If you wish, you can add multiple accounts (your own and that of your family members) and export all data using this tool.

Add an account

ente account add

List accounts

ente account list

Change export directory

ente account update --email email@domain.com --dir ~/photos

Export

Start export

ente export

CLI Docs

You can view more cli documents at docs. To update the docs, run the following command:

go run main.go docs

Docker

If you fancy Docker, you can also run the CLI within a container.

Configure

Modify the docker-compose.yml and add volume. cli-data volume is mandatory, you can add more volumes for your export directory.

Build the docker image

docker build -t ente:latest .

Note that BuildKit is needed to build this image. If you face this issue, a quick fix is to add DOCKER_BUILDKIT=1 in front of the build command.

Start the container in detached mode

docker-compose up -d

exec into the container

docker-compose exec ente /bin/sh

Directly executing commands

docker run -it --rm ente:latest ls