Skip to content

Latest commit

 

History

History
53 lines (33 loc) · 2.04 KB

README.md

File metadata and controls

53 lines (33 loc) · 2.04 KB

ComicArchive

A command line app and library for manipulating comic archives (.cbz, .cbr, etc). Written in C# and .Net Core 2.0.

Limitations

Command Line App

  • The read command looks for embedded Comic Rack metadata. If that isn't present then nothing is returned
  • The convert command line can convert a single archive (or a folder of archives) into a Zip based comic archive

Comic Archive Library

Things the library currently supports:

  • Conversion of various archive formats to a zip archive (with a .cbz extension)
  • Extracting a file from an archive by name, based on a file path
  • Determining if a file path is an archive
  • Reading Comic Rack metadata from an archive

Usage

Command Line

   read|r: Read the metadata for a comic archive. Only supports reading Comic Rack metadata.
        /p /path : (String) (Required)

   convert|c: Convert non-zip comic archives into zip archives.
        /o /overwrite     : If a file with the same name as the conversion target exists, replace it.
        /p /path          : The file or folder of files to convert. (String) (Required) (Path exists (file or directory))
        /r /replace       : Delete the original file once the conversion is complete.
        /s /showfullpaths : Show full file paths instead of just the files name.

C# Library

TODO:

To Do List

Priority

  • Switch to a better command line parser (try CommandLine).

Short Term

  • Move the conversion of an archive inside the ComicArchiveFile abstraction.
  • Implement parsing and saving of basic metadata from a filename if metadata not present.

Long Term

  • [Eventually] Implement ability to write most/all metadata to archives. Only zip files will be supported for writing initially. Other open standard formats may be supported one day, but Zip is the only open commonly used format, so there is probably no demand to support other formats. I see no benefit from using RAR that is worth taking the dependency on a proprietary 3rd party tool and philosophically oppose the use of RAR for comic archives.