# mod-meta

> Tracker mod metadata for .mod .xm .s3m .it

Latest version **1.0.0** (published 2026-02-09) · MIT license · 0 weekly downloads

## Install

```sh
npm install mod-meta
pnpm add mod-meta
yarn add mod-meta
bun add mod-meta
```

## Health

**Score 55/100 (C)** — status: stable.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2026-02-09 |
| First published | 2016-02-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 13.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Mykhailo Onikiienko |
| Maintainers | onikienko |
| Keywords | tracker, mod, metadata, tracker-music, .mod, .xm, .s3m, .it |

## Links

- npm: https://www.npmjs.com/package/mod-meta
- Repository: https://github.com/onikienko/mod-meta
- Homepage: https://github.com/onikienko/mod-meta#readme
- Issues: https://github.com/onikienko/mod-meta/issues
- npm.io page: https://npm.io/package/mod-meta

## Alternatives

- [react-native-root-siblings](https://npm.io/package/react-native-root-siblings.md) — 102.9K weekly downloads
- [@praxisui/dialog](https://npm.io/package/@praxisui/dialog.md) — 2.0K weekly downloads
- [easy-toggle-state](https://npm.io/package/easy-toggle-state.md) — 350 weekly downloads
- [ngx-lightbox-evp](https://npm.io/package/ngx-lightbox-evp.md) — 19 weekly downloads
- [react-native-modal-translucent-axton](https://npm.io/package/react-native-modal-translucent-axton.md) — 4 weekly downloads

## Recent versions

- 1.0.0 (latest) — 2026-02-09
- 0.1.1 — 2016-02-11
- 0.1.0 — 2016-02-05

## README

# mod-meta

Tracker mod metadata parser for .mod .xm .s3m .it

Returns `title`, `trackerType`, and `message` (when present in the module data).

## Why

I created this package in 2016 for the needs of my [keygenmusic.tk](https://keygenmusic.tk) project.

## Installation

`$ npm install mod-meta`

## Usage

```javascript
const mm = require('mod-meta');

// sync
const mdata = mm.getModMetaSync('pathToMod');
if (mdata) {
  console.log('Mod title: ', mdata.title);
  console.log('Tracker type: ', mdata.trackerType);
  console.log('Message: ', mdata.message);
} else {
  console.log('Error');
}

// sync (skip message parsing)
const mdataNoMsg = mm.getModMetaSync('pathToMod', {includeMessage: false});

// async (promise)
mm.getModMeta('pathToMod')
  .then((mdata) => {
    console.log('Mod title: ', mdata.title);
  })
  .catch((error) => {
    console.log(error);
  });

// async (promise, skip message parsing)
mm.getModMeta('pathToMod', {includeMessage: false})
  .then((mdata) => {
    console.log('Mod title: ', mdata.title);
  })
  .catch((error) => {
    console.log(error);
  });
```

## Tests

`$ npm test`

---
_Source: https://npm.io/package/mod-meta · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._