Node.js wrapper for anitomy

Downloads in past


2105.1.08 months ago6 years agoMinified + gzip package size for anitomy-js in KB


Actions Status GitHub license
anitomy-js is a Node.js wrapper for Anitomy - a C++ library for parsing anime video filenames.


  • Linux: gcc/g++ >= 5
  • Windows: Visual Studio >= 2015 (With C++ build tools)
  • Mac OS >= 10.9 (with Xcode installed, of course)


With npm do:
npm install anitomy-js

anitomy-js builds it's dependencies upon installation. Please refer to the node-gyp documentation if you're having problems with the build.

Version 1.x

Starting with version 1.0 the minimum supported Node version is 0.12

Changes from version 2.x

Starting with version 2.0, anitomy-js requires C++ 14 and at least Node 4:
  • Linux: GCC/G++ >= 5
  • Windows: Visual Studio >= 2015
  • Mac OS >= 10.9

If you can't update your build tools, all versions from 1.x are compatible with C++ 11.

Changes from version 3.x

Starting with version 3.0 the old callback style with a single argument is deprecated. You should switch to either use the Promise API or a node style callback (err, data). The minimum supported Node version is 6.

Changes from version 4.x

4.x is a complete rewrite from scratch and requires at least Node 8. The old callback style API was completely removed and now the async methods (parse and parseAsync) exposes only the Promise API.

Changes from version 5.x

On version 5.x, anitomy-js switched from using NAN, to the newer NAPI. With this change, all context-related issues should be fixed.


anitomy-js provides two methods: parse and parseSync. Both methods accept single filename input or an array of filenames for batch parsing.
Additionally you can pass an object as the last parameter to change Anitomy's original parsing options. The options are:
  • allowed_delimiters - defaults to " _.&+,|"
  • ignored_strings - defaults to []
  • parse_episode_number - defaults to true
  • parse_episode_title - defaults to true
  • parse_file_extension - defaults to true
  • parse_release_group - defaults to true

parse(data, options) -> Promise\>

var anitomy = require('anitomy-js')
  .parse('[tlacatlc6] Natsume Yuujinchou Shi Vol. 1v2 & Vol. 2 (BD 1280x720 x264 AAC)')
  .then((data) => console.log(data))

... would be parsed into
  "anime_title": "Natsume Yuujinchou Shi",
  "audio_term": "AAC",
  "file_name": "[tlacatlc6] Natsume Yuujinchou Shi Vol. 1v2 & Vol. 2 (BD 1280x720 x264 AAC)",
  "release_group": "tlacatlc6",
  "release_version": "2",
  "source": "BD",
  "video_term": "x264",
  "video_resolution": "1280x720",
  "volume_number": ["1", "2"]

parseSync(data, options) -> AnitomyResult | AnitomyResult

var anitomy = require('anitomy-js')
var filenames = [
  '[DmonHiro] Magi - The Labyrinth Of Magic - Vol.1v2 (BD, 720p)',

... would be parsed into
    "anime_title": "Magi - The Labyrinth Of Magic",
    "file_name": "[DmonHiro] Magi - The Labyrinth Of Magic - Vol.1v2 (BD, 720p)",
    "release_group": "DmonHiro",
    "release_version": "2",
    "source": "BD",
    "video_resolution": "720p",
    "volume_number": "1"
    "anime_title": "D.Gray-man",
    "episode_number": "04",
    "file_extension": "avi",
    "file_name": "[KLF]_D.Gray-man_04V2",
    "release_group": "KLF",
    "release_version": "2"


Licensed under the incredibly permissive MIT license