{"id":19239182,"url":"https://github.com/atomotic/archiviiify","last_synced_at":"2025-04-21T07:32:02.349Z","repository":{"id":146672714,"uuid":"276402932","full_name":"atomotic/archiviiify","owner":"atomotic","description":"Download digitized books from Internet Archive and view with IIIF, locally and offline.","archived":false,"fork":false,"pushed_at":"2024-04-19T12:22:38.000Z","size":534,"stargazers_count":38,"open_issues_count":1,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-01T10:51:24.643Z","etag":null,"topics":["code4lib","digital-libraries","iiif","internetarchive"],"latest_commit_sha":null,"homepage":"https://literarymachin.es/archiviiify/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/atomotic.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,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-07-01T14:41:51.000Z","updated_at":"2025-03-19T04:45:49.000Z","dependencies_parsed_at":"2024-04-19T13:40:10.886Z","dependency_job_id":"b100b345-d981-4a8a-b88d-3779a0de00a7","html_url":"https://github.com/atomotic/archiviiify","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomotic%2Farchiviiify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomotic%2Farchiviiify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomotic%2Farchiviiify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/atomotic%2Farchiviiify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/atomotic","download_url":"https://codeload.github.com/atomotic/archiviiify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250014718,"owners_count":21360999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["code4lib","digital-libraries","iiif","internetarchive"],"created_at":"2024-11-09T16:37:47.450Z","updated_at":"2025-04-21T07:32:01.117Z","avatar_url":"https://github.com/atomotic.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://docuver.se/assets/archiviiify.png\" width=50% height=50%\u003e\n\n**Archiviiify** is a streamlined command-line interface tool designed to empower you to effortlessly acquire digitized books from the Internet Archive in the JPEG2000 format and access them via IIIF on your local machine, even when disconnected from the internet. While not intended to serve as a public IIIF service for the Internet Archive, it proves exceptionally beneficial for personal research, academic pursuits, and as a resource for honing your IIIF application development skills.\n\nIn its earlier iteration, Archiviiify was a more complex amalgamation of scripts and components, as documented [here](https://literarymachin.es/archiviiify/), with the code residing in the [v1](https://github.com/atomotic/archiviiify/tree/v1) branch. The updated version features a unified command-line interface (CLI) and a single Docker image, making the installation and usage process smoother.\n\nPlease be aware that the full-text search service is not currently available in this release.\n\n# Quickstart\n\nDownload a [release](https://github.com/atomotic/archiviiify/releases) for your platform, or build the cli\n\n```\nhttps://github.com/atomotic/archiviiify/\ncd archiviiify\ngo build\n```\n\nSet up the project structure and make any necessary adjustments to the `.env` file.\n\n```\n./archiviiify init\n\n# init — the following directories have been created\n├── archiviiify\n├── data\n│   ├── .env\n│   ├── images\n│   ├── manifests\n│   └── www\n│       └── index.html\n└── docker-compose.yml\n```\n\nStart the docker container. The official [iipsrv image](https://hub.docker.com/r/iipsrv/iipsrv) will be downloaded from Docker Hub\n\n```\n~ docker-compose up -d\n\n~ docker-compose ps\nNAME            IMAGE           COMMAND            SERVICE   CREATED          STATUS              PORTS\ntest-iipsrv-1   iipsrv/iipsrv   \"/bin/sh -c run\"   iipsrv    54 minutes ago   Up About a minute   9000/tcp, 0.0.0.0:9000-\u003e80/tcp, :::9000-\u003e80/tcp\n```\n\nDownload an [item](https://internetarchive.readthedocs.io/en/stable/items.html) from Internet Archive. The IIIF manifest will be generated, providing access to a local Mirador viewer for browsing.\n\n```\n~ ./archiviiify get -i wholeearthcatalo00unse_1\n\narchiviiify\n\n[1/3] Downloading Whole Earth Catalog   Spring 1970:\n Source: https://ia903200.us.archive.org/23/items/wholeearthcatalo00unse_1/wholeearthcatalo00unse_1_jp2.zip\n 236.29 MiB / 236.29 MiB [===================================================================================================================================] 100.00% 1m56s\n[2/3] Generating IIIF manifest\n[3/3] View the IIIF manifest at:\n http://localhost:9000/?manifest=wholeearthcatalo00unse_1\n```\n\n# Limitations\n\n* The command-line interface (CLI) design is currently a work in progress and needs improvement in terms of aesthetics.\n* The metadata embedding in IIIF manifest has not been fully tested, and may require further optimization.\n* Currently, the IIIF manifest generation does not support items containing multiple subitems. This issue can be resolved by using an IIIF collection manifest.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomotic%2Farchiviiify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fatomotic%2Farchiviiify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fatomotic%2Farchiviiify/lists"}