Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Server for comic scan data.

See ComicScanner for a more detailed discussion. That is designed to be the key client for this web service.

However, in short, ScanData is intended to be a web service similar in spirit to the venerable Compact Disc Database or its successor freedb, except for comic book scan archive files.

While it may change over time, the current vision is for ScanData to be a straightforward CRUD site, with a standard REST API for clients to use for accessing or updating the data.

##Architecture and Schema

Coming Soon, though the architecture is primarily a straightforward Ruby on Rails application.


TBD, though almost certainly using JSON-based REST calls.

The current thinking is that three API calls are necessary to start.

  • /submission/new.json, primarily for tools such as ComicScanner, allows POSTing of a JSON array of objects with automatically-readable file information that can be used to fill the various parts of the file model. Such tools must notify the user that submissions are not complete until visiting the website to hand-input the remaining data. (Note: As the API becomes more flexible, it might be reasonable for a client program to collect this information from the user and POST it through the proper channel, but that would be a future plan.)

  • /documents/hash.json, primarily for comic-reading applications, returns the relevant JSON document, archive, image, alias, and inclusion objects for the submitted hash value, minus any sensitive data. (Note: Eventually, this will have an interface that allows for POSTing a JSON array of hash values, returning arrays of objects.)

  • /aliases/list/name.json, also for comic-reading applications, returns an array of JSON document objects that have the same or similar names.

If XML turns out to be popular, that can be turned on, as well, though it appears to be falling out of favor.

##Data Storage

As mentioned in the ComicScanner project, data from this project will be made freely available, as is the code for both the client and server, under liberal licensing terms.

The intent is to make it easy to reconstruct the infrastructure, should anything happen to it. The only information that won't be shared is information on users, except possibly in aggregate.


Server for comic scan data







No releases published


No packages published