# skipa organizer
skipa means ("organize, arrange, place in order") in Old Norse
![skipa logo](https://raw.githubusercontent.com/uriel1998/skipa/master/skipa-open-graph.png "logo")
4. [How to use](#4-how-to-use)
## 1. About
`skipa` is designed to fix and write tags in PDF files so they can be organized
more easily and more tool-agnostically.
I personally use three main tools for indexing and searching my PDF paperwork:
However, I've scanned PDF reciepts without adding keywords or tags or even
dates before. `skipa` can be pointed at a single file or at an entire
directory to read metadata from the PDF itself - and what is in the filename -
resolve conflicts, and re-write that metadata in the file itself and in
*note: I treat the metadata "Keywords" and the term "tags" interchangeably here*
## 2. License
This project is licensed under the MIT license. For the full license, see `LICENSE`.
## 3. Prerequisites
### These may already be installed on your system or easily installable by package manager.
* `stat` (coreutils)
* `date` (coreutils)
To install them on Debian, simply type `sudo apt install grep gawk sed wkhtmltopdf html2text detox xpdf yad libimage-exiftool-perl coreutils file` .
## 4. How to use
The filename format that is generated is a combination of what `gscan2pdf` will create
and what `TagSpaces` creates. It is in the format:
`TITLE_With_Spaces_as_underscores-YYYY-MM-DD[TAG TAG TAG].pdf`
Usage is straightforward:
`skipa.sh [ path_to_pdf_files | pdf_file ]`
Any conflict between the metadata will be presented for resolution. Choose the appropriate
radio button or choose "manual resolution" to edit during the loading process.
Once the metadata is loaded, it will all be presented in one dialog box. Additionally, the
file will be loaded in `xpdf` to assist if all the metadata is missing. Click **save** to
rename the file and write the metadata into the file itself.
While it uses exiftool to read and write metadata to the file, `skipa` is currently
focusing on PDF files at this time. If asked to work in directory mode, it
uses the `file` utility to only work on PDF files.
## 5. Todo
* just make sure there's no mismatches mode
* just make sure there's no empty mode
* Mendeley renaming and metadata writing
* is there OCR mode