Package: exhibiter
This is a tool to help assemble evidence for litigation. Given an organized folder of PDFs and images, Exhibiter can create a single PDF containing all the evidence, complete with cover sheets and page numbers. It also creates an exhibit list as a Word document. An example of its inputs and outputs is availablehere.I made this tool in the hopes that it would make eviction defense a little easier. Others may use it as well, but eviction plaintiffs and their representatives may not.InstallationIf you use Windows or MacOS, head to theReleasespage and download the latest.exeor.app, respectively. Save it wherever you want, and it's installed! Just double-click it whenever you want to run it.Alternatively, if you use Linux, or if you just want to run the program from a command-line, you can install it withpip. To do that, ensure thatPython 3is installed, then run the following command:python3-mpipinstallexhibiterAfter that, you should be able to launch the Exhibiter GUI with theexhibitercommand, or the command-line interface withexhibiter-cli.UsageBefore you can use Exhibiter to compile evidence, you'll need to do a little work to rename and organize the input files.First, let's define some basic concepts:Theinput folderis the folder that you'll ultimately tell Exhibiter to process. It must contain one or more exhibit folders.Exhibitsare the files and folders located directly within the input folder. They can be PDFs, photos, or folders full of PDFs or photos. Every exhibit will have its own row in the exhibit list, and its own cover sheet in the main evidence PDF.As noted above, an exhibit can be a folder.Documentsare the files and folders located directly within an exhibit folder. Like exhibits, they can be PDFs, photos, or folders full of PDFs or photos. The exhibit list will display brief a description of each document in every exhibit.The sections below give a bit more detail on these concepts. If you want an example of a completed input folder, seehere.Name the ExhibitsEvery exhibit's filename (or folder name) must have a number or capital letter. For instance,101andAare both valid folder names, representing Exhibit 101 or Exhibit A, respectively.You may also give each exhibit a title. If an exhibit is a folder full of named documents, the title is optional. If the exhibit is a PDF or image, itmusthave a title.An exhibit has a title if, after the exhibit number, the filename has a period, space, and then some text. An example of a titled exhibit is103. Party Communications.Finally, you may also add(UNUSED)at the end of a filename, indicating that Exhibiter should omit this exhibit unless expressly told otherwise. This is useful for evidence that should be produced in discovery but which you do not plan to introduce at trial.Organize the DocumentsAs noted above, exhibits can be folders full of individual named documents. A document can be a PDF, an image in JPG or PNG format, or a folder full of PDFs or images. In any case, the document's filename determines how and where the document will appear. Note that if a document is a folder, the relevant filename is the name of thefolder, not the files inside.Within each exhibit, documents will be arranged in alphabetical order based on their filenames.Each document will appear in the exhibit list with a description derived from its filename. Exhibiter has some opinions about how to turn filenames into descriptions, so you'll need to understand its process so that you can write filenames in a compatible format:First, Exhibiter removes the file extension, e.g..pdf.If the filename starts with a number followed by a period and a space, Exhibiter removes this number, on the assumption that it's only meant for indicating the order of documents.If the filename starts with a date in YYYY-MM-DD or YYYYMMDD format, Exhibiter moves it to the end of the description, in M/D/YY format. If chronology is important, you should start filenames with these dates so that they will appear in chronological order. An example document filename is2019-01-03 Rent Payment.jpg.If the document's filename ends with(UNUSED), the document will normally be omitted, the same way that entire exhibits with that tag will be omitted. If you tell Exhibiternotto omit such documents, the word(UNUSED)will be omitted from the description.Run the ProgramFinally, you're ready to run the program, by double-clicking the executable if you followed the Windows or MacOS instructions, or by running theexhibitercommand if you installed it frompip. You should see a window like this:You can mouse over any of the options to see a description of what it does.