tinybeans-sync
Downloads original quality images from Tinybeans photo journals.
Quickstart
From PyPI:
pip install tinybeans-sync
Or from source:
git clone https://github.com/brege/tinybeans-sync.git
cd tinybeans-sync
pip install .
Test it out:
tinybeans-sync --help
After copying config.yaml.example to ~/.config/tinybeans-sync/config.yaml, fill in your
- password
- tinybeans_id (you can get this from journal URLs)
You should also configure the download path for all of photos.
download:
output_dir: downloads # relative to this project dir, or absolute path
Automated syncing with systemd
To run tinybeans-sync automatically every 12 hours, use the provided systemd timer:
bash <(curl https://raw.githubusercontent.com/brege/tinybeans-sync/refs/heads/main/systemd/install.sh)
This will
- Download and install the systemd service and timer files
- Replace placeholders with your username and group
- Enable the timer to check every 12 hours, relative to boot time
This install script can be found in GitHub.
Timer status:
systemctl status tinybeans-sync.timer
systemctl list-timers
journalctl -u tinybeans-sync.service
Usage
Options:
tinybeans-sync --help
Download images from last successful run date onwards:
tinybeans-sync --from-last-date
Download a date range:
tinybeans-sync --after 2025-06-01 --before 2025-08-31
Catch up from a specific day through today:
tinybeans-sync --after 2025-10-27
Force re-download (ignores history file):
tinybeans-sync --after 2025-06-01 --force
History
Downloaded files are tracked in ~/.config/tinybeans-sync/tinybeans_history.json (or your --data directory) to avoid re-downloading deleted images.
Delete that history file to start fresh, or rerun with --after <date> to start from a specific date. Use --force to restore image files from a date range or over a date range via --before and --after.
Roadmap
- support video downloads
License
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tinybeans_sync-0.4.tar.gz.
File metadata
- Download URL: tinybeans_sync-0.4.tar.gz
- Upload date:
- Size: 21.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
201a722e41131dc002963b9f332bad25e87e3f3c337a803eefcd3dddee8a5c92
|
|
| MD5 |
27cec62b39fbdd587a00ad857a413034
|
|
| BLAKE2b-256 |
88c395faf00b5118657e81a5649c57b3a0cbed1fb313ca0e29d4bdca41cbd2c6
|
Provenance
The following attestation bundles were made for tinybeans_sync-0.4.tar.gz:
Publisher:
publish.yml on brege/tinybeans-sync
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tinybeans_sync-0.4.tar.gz -
Subject digest:
201a722e41131dc002963b9f332bad25e87e3f3c337a803eefcd3dddee8a5c92 - Sigstore transparency entry: 2256566054
- Sigstore integration time:
-
Permalink:
brege/tinybeans-sync@9ae423607d4db70c530fc87738637bbd8f476604 -
Branch / Tag:
refs/tags/v0.4 - Owner: https://github.com/brege
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9ae423607d4db70c530fc87738637bbd8f476604 -
Trigger Event:
release
-
Statement type:
File details
Details for the file tinybeans_sync-0.4-py3-none-any.whl.
File metadata
- Download URL: tinybeans_sync-0.4-py3-none-any.whl
- Upload date:
- Size: 22.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3e050c162a0dece4416064f8c2f4249f1eae5b4b27d4b010847fc202432b9820
|
|
| MD5 |
ce5af98eecfa4cd9e275be1c7cb152c7
|
|
| BLAKE2b-256 |
798fdc8c677b94a5df4e8f10cff6526ec6015aebf8d34f20bf3bc633c221f8b9
|
Provenance
The following attestation bundles were made for tinybeans_sync-0.4-py3-none-any.whl:
Publisher:
publish.yml on brege/tinybeans-sync
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
tinybeans_sync-0.4-py3-none-any.whl -
Subject digest:
3e050c162a0dece4416064f8c2f4249f1eae5b4b27d4b010847fc202432b9820 - Sigstore transparency entry: 2256566060
- Sigstore integration time:
-
Permalink:
brege/tinybeans-sync@9ae423607d4db70c530fc87738637bbd8f476604 -
Branch / Tag:
refs/tags/v0.4 - Owner: https://github.com/brege
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@9ae423607d4db70c530fc87738637bbd8f476604 -
Trigger Event:
release
-
Statement type:
