{"id":34231479,"url":"https://github.com/moycat/vaar","last_synced_at":"2026-03-10T16:12:52.331Z","repository":{"id":57637227,"uuid":"426896493","full_name":"moycat/vaar","owner":"moycat","description":"Tar toolkit optimized for high volumes of small files.","archived":false,"fork":false,"pushed_at":"2022-03-10T17:41:34.000Z","size":45,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-06-20T18:18:08.220Z","etag":null,"topics":["posix","tar","tool"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/moycat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-11T06:35:34.000Z","updated_at":"2023-08-14T11:46:30.000Z","dependencies_parsed_at":"2022-09-26T20:21:58.254Z","dependency_job_id":null,"html_url":"https://github.com/moycat/vaar","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/moycat/vaar","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moycat%2Fvaar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moycat%2Fvaar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moycat%2Fvaar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moycat%2Fvaar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/moycat","download_url":"https://codeload.github.com/moycat/vaar/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/moycat%2Fvaar/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30342161,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T15:55:29.454Z","status":"ssl_error","status_checked_at":"2026-03-10T15:54:58.440Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["posix","tar","tool"],"created_at":"2025-12-16T01:15:29.354Z","updated_at":"2026-03-10T16:12:52.322Z","avatar_url":"https://github.com/moycat.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🐳 Vaar 📦\n\n**Va**ala **ar**chive is a tar archive tool \u0026 library optimized for lots of small files.\n\nWritten in Golang, vaar performs operations in parallel \u0026 fully utilizes the POSIX APIs to reduce filesystem overheads.\n\nVaar is capable of tar creation \u0026 extraction. It works only on Linux \u0026 macOS.\n\nVaar is in beta. Some bugs are still out there 🙏\n\n## Install\n\nGo 1.16+ is required to compile vaar.\n\n**As a command**\n\n```shell\ngo install github.com/moycat/vaar/cmd/vaar@latest\n```\n\n**As a library**\n\n```go\nimport \"github.com/moycat/vaar\"\n```\n\n## CLI Usage\n\nSuppose you have `$GOPATH/bin` in your `PATH`.\n\nThe common usage to create a tarball is:\n\n```shell\nvaar create [-c \u003calgorithm\u003e] [-l \u003clevel\u003e] [-r \u003cread_ahead\u003e] \u003ctarball\u003e \u003cfile ...\u003e\n```\n\n**Arguments:**\n\n- `-c \u003calgorithm\u003e`: Compression algorithm, `lz4` or `gzip`. No compression by default.\n- `-l \u003clevel\u003e`: Compression level, `fastest`, `fast`, `default`, `good` or `best`.\n- `-r \u003cread_ahead\u003e`: Read ahead size, the maximum number of files to be walked and stated ahead. `512` by default.\n\n**Examples:**\n\n- Create a tarball with LZ4 compression: `vaar c -c lz4 archive.tar.lz4 seagrass kombu`\n- Create a tarball with a large read ahead size: `vaar c -r 4096 archive.tar shrimps`\n\nThe common usage to extract a tarball is:\n\n```shell\nvaar extract [-c \u003calgorithm\u003e] [-d \u003ctarget\u003e] [-s \u003cbuffer_threshold\u003e] [-t \u003cthread\u003e] [-r \u003cread_ahead\u003e] \u003ctarball\u003e\n```\n\n**Arguments:**\n\n- `-c \u003calgorithm\u003e`: Compression algorithm, `lz4` or `gzip`. No compression by default.\n- `-d \u003ctarget\u003e`: Extraction target path. `.` by default.\n- `-s \u003cbuffer_threshold\u003e`: The size threshold for a file to be buffered in KiB. `512` by default.\n- `-t \u003cthread\u003e`: The number of buffered extraction thread. `4` by default.\n- `-r \u003cread_ahead\u003e`: Read ahead size, the maximum number of files to be extracted ahead. `512` by default.\n\n**Examples:**\n\n- Extract a LZ4-compressed tarball to `/tmp`: `vaar x -c lz4 -d /tmp archive.tar.lz4`\n- Extract a tarball with high concurrency: `vaar x -s 4096 -t 32 -r 2048 archive.tar`\n\n## Appendix\n\n*Vaal* means *whale* in Estonian, with *Vaala* being its genitive form.\n\nGigantic [baleen whales](https://en.wikipedia.org/wiki/Baleen_whale) like blue whales eat a large volume of tiny fish and shrimp with extremely high efficiency, by swallowing and filtering tons of water every time they open their mouths.\n\n```\n ________\n\u003c Yummy! \u003e\n --------\n    \\\n     \\\n      \\\n                    ##        .\n              ## ## ##       ==\n           ## ## ## ##      ===\n       /\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"\"___/ ===\n  ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~\n       \\______ o          __/\n        \\    \\        __/\n          \\____\\______/\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoycat%2Fvaar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmoycat%2Fvaar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmoycat%2Fvaar/lists"}