Skip to main content

ThinIce - friendly client for Amazon Glacier

Thinice is a user-friendly client for AWS Glacier that features a local inventory. This local inventory allows you to instantly list uploaded archives, as retrieving inventory from Glacier can take several hours.

With the local inventory, you can quickly list archives by filename (ArchiveDescription), size, and upload age.

Install

pipx method is recommended (pipx is easy to install).

pipx install thinice

or (better if in virtualenv):

pip3 install thinice

Configuration

Create the config directory using the command mkdir ~/.config/thinice, and then create the config file at ~/.config/thinice/thinice.env. Here’s an example:

AWS_ACCESS_KEY_ID = AK...
AWS_SECRET_ACCESS_KEY = FN...
AWS_REGION = eu-south-1
AWS_GLACIER_VAULT = mytest

Alternatively, you can supply this information via options: --key-id, --secret-key, --region, and --vault.

Basic commands

Inventory

First, you need to initialize the local inventory:

# Request inventory
thinice inventory

# Monitor when the job is complete (this may take a few hours)
thinice job

# Accept the inventory with the same command
thinice inventory

# Now you can list files
thinice ls

Upload

Thinice supports multipart uploads and can handle upload of very large files

# No description explicitly given, description will be myarchive.zip
thinice upload /path/to/myarchive.zip

# Upload with description
thinice upload /path/to/myarchive.zip "My archive from 01/02/2003"

Download

# To download, we should *warm* the file by transitioning it from cold to warm storage
# Here we use expedited retrieval tier to get file very fast.
thinice request myarchive.zip -t expedited

# Or by the first part of the ArchiveId (default: standard tier)
thinice request S39to

# Monitor the list to see when it becomes warm (this will take a few hours)
thinice ls


# Finally, download it
# A file with the description MyServer.tar.gz will be saved as MyServer.tar.gz (only if the description is a filename)
thinice download myarchive.zip

# Download a file with an ArchiveId starting with these characters
thinice download S39to myarchive.zip

Delete

# delete archive with this ArchiveId
thinice delete S39to

# delete all archives with this ArchiveDescription
thinice delete myarchive.zip

Other commands

# help
thinice -h
thinice download -h

# list vaults
thinice vaults

# list jobs
thinice jobs

Metadata

Release files for thinice 1.0.26

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for thinice 1.0.26
File Size Uploaded Provenance
thinice-1.0.26.tar.gz 17.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for thinice 1.0.26
File Interpreter ABI Platform
thinice-1.0.26-py3-none-any.whl Python 3 none any Details

Total release size: 40.9 kB

Release files / thinice-1.0.26.tar.gz

Download URL thinice-1.0.26.tar.gz
Size 17.2 kB
Tags Source
SHA-256 checksum
How to use checksums
fa8e6d7df236ada8ac5172d616a8c14894ff268366028ac36df27c6c9a5d3e81
BLAKE2b-256 checksum
How to use checksums
195ef63ad967bb505ad53801187ddbc42fc6492756a1098fe2c1ed5e731a58a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.27.2

Release files / thinice-1.0.26-py3-none-any.whl

Download URL thinice-1.0.26-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1e2df543f1425e7cb486eae309843c13a037dea40e7d5b60a355606d6772e100
BLAKE2b-256 checksum
How to use checksums
9dc242c7e5be7dbce4486295401dedf712e15dbce5b25136503efa3808a396f5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via python-httpx/0.27.2

Security for thinice 1.0.26

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page