{"id":13588362,"url":"https://github.com/PDF-Archiver/PDF-Archiver","last_synced_at":"2025-04-08T03:33:57.256Z","repository":{"id":37548418,"uuid":"119609777","full_name":"PDF-Archiver/PDF-Archiver","owner":"PDF-Archiver","description":"A tool for tagging files and archiving tasks.","archived":false,"fork":false,"pushed_at":"2024-10-28T21:09:57.000Z","size":115135,"stargazers_count":303,"open_issues_count":5,"forks_count":24,"subscribers_count":15,"default_branch":"develop","last_synced_at":"2024-10-30T00:32:56.446Z","etag":null,"topics":["archive","archiving","archivist","archivist-toolkit","conventions","filesystem","icloud","icloud-drive","letters","macos","macos-app","pdf","pdf-archiver","scanbot","searchterm","swift","swift4"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PDF-Archiver.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":"JulianKahnert","issuehunt":null,"otechie":null,"custom":null}},"created_at":"2018-01-30T23:55:53.000Z","updated_at":"2024-10-30T00:24:12.000Z","dependencies_parsed_at":"2023-02-16T12:45:36.794Z","dependency_job_id":"45098719-f000-4d97-a1eb-cd2eed0e6d0a","html_url":"https://github.com/PDF-Archiver/PDF-Archiver","commit_stats":null,"previous_names":[],"tags_count":96,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PDF-Archiver%2FPDF-Archiver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PDF-Archiver%2FPDF-Archiver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PDF-Archiver%2FPDF-Archiver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PDF-Archiver%2FPDF-Archiver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PDF-Archiver","download_url":"https://codeload.github.com/PDF-Archiver/PDF-Archiver/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223214469,"owners_count":17107507,"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":["archive","archiving","archivist","archivist-toolkit","conventions","filesystem","icloud","icloud-drive","letters","macos","macos-app","pdf","pdf-archiver","scanbot","searchterm","swift","swift4"],"created_at":"2024-08-01T15:06:39.897Z","updated_at":"2025-04-08T03:33:57.234Z","avatar_url":"https://github.com/PDF-Archiver.png","language":"Swift","readme":"\u003cp align=\"center\"\u003e\n\u003ca href=\"https://apps.apple.com/app/apple-store/id1433801905?pt=118993774\u0026ct=GitHub\u0026mt=8\" target=\"itunes_store\"\u003e\n  \u003cimg src=\"assets/AppIcon.svg\" width=\"200px\"\u003e\n\u003c/a\u003e\n\u003cbr\u003e\n\u003cbr\u003e\n\u003ca href=\"https://apps.apple.com/de/app/pdf-archiver/id1433801905?itsct=apps_box_badge\u0026amp;itscg=30200\" style=\"display: inline-block; overflow: hidden; border-radius: 13px; width: 250px; height: 83px;\"\u003e\u003cimg src=\"https://tools.applemediaservices.com/api/badges/download-on-the-app-store/black/de-de?size=250x83\u0026amp;releaseDate=1539734400\" alt=\"Download on the App Store\" style=\"border-radius: 13px; width: 250px; height: 83px;\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# PDF Archiver\n\nArchive all incoming documents digitally to access and search them in an easier way.\nTransfer the sorted documents to your smartphone or make a backup within seconds.\n\n* Scan all incoming bills, letters etc. and save them on your computer/iCloud in an *untagged* folder.\n* Put the original paper documents in a folder, sorted by year. Don't care about bills/insurance papers etc.. Just leave all of them in one box for the each year.\n* Open the **PDF Archiver** and start tagging. Your documents will be moved from the *untagged* to your *Archive* folder.\n\n## :rocket: Usage\n1. Scan your documents with [PDF Archiver for iOS](http://ios.pdf-archiver.io)\n2. Start tagging your files on macOS or iOS\n3. There is not step 3 🤷🏻‍♂️\n\n## :scroll: Convention\n* **Date:** `yyyy-mm-dd` Date of the document content.\n* **Description:** `--ikea-tradfri-gateway` Meaningful description of the document.\n* **Tags:** `__bill_ikea_iot` Tags which will help you to find the document in your archive.\nCapital letters, spaces and language specific characters (such as `ä, ö, ü, ß`) will be removed to maximize the filesystem compatibility.\n\nYour archive will look like this:\n```\n.\n└── Archive\n    ├── 2017\n    │   ├── 2017-05-12--apple-macbook__apple_bill.pdf\n    │   └── 2017-01-02--this-is-a-document__bill_vacation.pdf\n    └── 2018\n        ├── 2018-04-30--this-might-be-important__work_travel.pdf\n        ├── 2018-05-26--parov-stelar__concert_ticket.pdf\n        └── 2018-12-01--master-thesis__finally_longterm_university.pdf\n```\n\nThis structure is independent from your OS and filesystem and makes it very easy to search files ...\n* ... by tag via a searchterm like: `_tagname`, starting with `_`\n* ... by description via a searchterm like: `-descriptionword`, starting with `-`\n* ... by tag or description via a searchterm like: `searchword`,  starting with the term\n* ... and even the file content: have a look at the [Pro Tips](#pro-tips)!\n\n\n## :floppy_disk: Installation\nDownload it from the App Stores [iOS](http://ios.pdf-archiver.io) and [macOS](http://macos.pdf-archiver.io)!\n\nOr clone the repository and build it:\n* Downloaded and install [Xcode.app](https://apps.apple.com/app/xcode/id497799835)\n* Get the project: `git clone --recurse-submodules https://github.com/PDF-Archiver/PDF-Archiver.git`\n* Build and run `PDF Archiver`\n\n## \u003ca name=\"pro-tips\"\u003e\u003c/a\u003e:mortar_board: Pro Tips\n### PDF Archiver for iOS\n* Scan your documents with the [iOS App](http://ios.pdf-archiver.io)\n* Use the text recognition from PDF Archiver and use the tag/date suggestions\n* Validate the suggestions and save the document in your archive with the [iOS App](http://ios.pdf-archiver.io) or [macOS App](http://macos.pdf-archiver.io)\n\n### PDF Archiver\n* Use the `↹` key for fast field switching\n* You can use keyboard shortcuts from the [FAQs](https://pdf-archiver.io/faq)\n\n## :interrobang: Help\n* Take a look at the [FAQs](https://pdf-archiver.io/faq).\n* Get in contact with us at [Discord](http://discord.pdf-archiver.io).\n\n## :octocat: How to contribute\nRate the App in the [Mac App Store](http://macos.pdf-archiver.io).\n\nAll [contributions](https://github.com/PDF-Archiver/PDF-Archiver/blob/develop/.github/CONTRIBUTING.md) are welcome!\nFeel free to contribute to this project.\nSubmit pull requests or contribute tutorials - whatever you have to offer, it would be appreciated!\n\n## :newspaper_roll: Featured on\n* [Macobserver](https://www.macobserver.com/reviews/quick-look/review-pdf-archiver/) - How to Archive PDFs with PDF Archiver\n* [iFun](https://www.ifun.de/pdf-archiver-kostenloser-ios-kompagnon-ergaenzt-die-mac-app-128930/) - Kostenloser iOS-Kompagnon ergänzt die Mac-App\n* [Netzwelt](https://www.netzwelt.de/download/24613-pdf-archiver.html) - PDF-Dokumente einfach verwalten\n* [Sir Apfelot](https://www.sir-apfelot.de/pdf-archiver-22021/) - PDFs verschlagworten, ordnen und archivieren\n* [appgefahren.de](https://www.appgefahren.de/pdf-archiver-praktische-mac-app-hilft-beim-langfristigen-verwalten-von-dokumenten-220759.html) - Mac-App hilft beim langfristigen Verwalten von Dokumenten\n\n## :book: Thanks and Donations\n* [**The.Swift.Dev.**](https://theswiftdev.com/2018/05/17/how-to-use-icloud-drive-documents/) for a sponsorship option on a blogpost I used while writing this app.\n* [**zngguvnf.org**](https://zngguvnf.org) discussing and creating this archive structure.\n* [**Karl Voit**](http://karl-voit.at/managing-digital-photographs/) for the initial idea of a document naming convention.\n* [**Nick Roach**](https://www.elegantthemes.com) for the [Icon](https://www.iconfinder.com/icons/1055071/document_file_icon).\n* MAS Preview Sound: [Love Jones by @nop](http://dig.ccmixter.org/files/Lancefield/50789)\n","funding_links":["https://liberapay.com/JulianKahnert"],"categories":["Swift","Applications","Productivity","File Management Tools"],"sub_categories":["Productivity","Text","Utils","⏱️ Productivity (54)"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPDF-Archiver%2FPDF-Archiver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPDF-Archiver%2FPDF-Archiver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPDF-Archiver%2FPDF-Archiver/lists"}