Norwegian Fake Data

A Python CLI for making Norwegian phone numbers, fødselsnummer, license plates, and character records for murder mystery games and props. Runs offline, with Rich terminal output and JSON/CSV exports.

Proudly sponsored by CaseClosed

Proudly sponsored by CaseClosed in Norway and Caseclosed Mysteries internationally, creators of printed murder mystery games.

Get started

You'll need Python 3.11 or newer and uv. Run commands with uvx, without a permanent installation:

uvx norwegian-fake-data phone
uvx norwegian-fake-data fnr --birthday 1987 5 17
uvx norwegian-fake-data plate --count 5
uvx norwegian-fake-data person --age 42 --vehicle

For a permanent installation, use uv tool install norwegian-fake-data. To pin a release, use uvx norwegian-fake-data@0.1.0 phone.

Phone numbers

uvx norwegian-fake-data phone --count 10 --unique
uvx norwegian-fake-data phone --international
uvx norwegian-fake-data phone --international --style compact

Numbers come from Nkom's reserved TV/film range, 68050000–68059999. Choose spaced output (68 05 12 34) or compact output (68051234), with an optional +47 prefix.

Fødselsnummer

Choose a birthday or an age:

uvx norwegian-fake-data fnr --birthday 1987 5 17
uvx norwegian-fake-data fnr --age 35 --as-of 2026-10-06
uvx norwegian-fake-data fnr --age 35 --exact-age --as-of 2026-10-06

--age 35 picks a random birthday for someone aged 35 on the reference date. On 2026-10-06, that's between 1990-10-07 and 1991-10-06. --exact-age instead uses 1991-10-06: their 35th birthday is on that date. --as-of defaults to today; set it to the date of your story.

Both modes produce fictional identifiers:

uvx norwegian-fake-data fnr --birthday 1987 5 17 --mode synthetic

Supported birth years are 1854–2039. February 29 birthdays advance in age on February 28 in non-leap years. JSON and CSV include the actual birthday, age, mode, and reference date alongside the number.

License plates

uvx norwegian-fake-data plate --count 5 --unique
uvx norwegian-fake-data plate --prefix QB
uvx norwegian-fake-data plate --prefix QC --compact

Plates use QA, QB, or QC followed by five digits, such as QB 12345. These prefixes were absent from Statens vegvesen's published plate series when checked on 2026-10-06; they are not an officially reserved film range.

Character records

uvx norwegian-fake-data person --age 42 --count 6 --unique --vehicle \
  --as-of 2024-11-15 --seed 73 --format json > characters.json

Each record contains a Norwegian name, birthday, age, FNR, phone, example.com email, and optional plate. It accepts the same birthday and mode options as fnr. Save the records to reuse the same details across letters, contact lists, and witness statements. Names are drawn from a small hand-curated list and may repeat.

Output options

Output defaults to Rich in a terminal and plain text when piped. Use a fixed --as-of with seeded age-based generation. Import identifier columns as text when opening CSV files in a spreadsheet to keep leading zeros.

uvx norwegian-fake-data phone --count 20 --format csv > phones.csv
uvx norwegian-fake-data --help
uvx norwegian-fake-data fnr --help

Using it from Python

from datetime import date
from norwegian_fake_data import generate_fnrs, generate_people, generate_phones, generate_plates

phones = generate_phones(5, seed=42, unique=True)
plates = generate_plates(5, seed=42, prefix="QA")
records = generate_fnrs(age=35, as_of=date(2026, 10, 6), seed=42)
characters = generate_people(6, age=42, seed=73, vehicle=True, unique=True)

print(records[0].fnr, records[0].birthday)

Data sources

• Nkom's numbering plan: the TV/film phone range.
• Statens vegvesen's plate series: plate format and prefix selection.
• Skatteetaten's test-data documentation: the synthetic month offset.
• Skatteetaten's checksum documentation: checksum calculations. Prop mode changes the final checksum, which fails both the traditional and published 2032 rules.

Development and publishing

From a checkout, run the CLI with uvx --from . norwegian-fake-data and use these commands for development:

uv sync --locked
uv run pytest
uv run ruff check .
uv run ruff format --check .
uv build
uv run twine check --strict dist/*

CI runs lint, tests, and the package build once on Ubuntu with Python 3.11. Pushing a version tag runs the checks and publishes the package to PyPI. Set the version in pyproject.toml, run uv lock, then commit and push before tagging that commit. For version 0.1.0:

git tag -a v0.1.0 -m "Release 0.1.0"
git push origin v0.1.0

The tag must match the package version. Use a new version and tag for each release. After publishing, run uvx --refresh norwegian-fake-data --version to get the latest.

Publishing uses PyPI Trusted Publishing from caseclosed-no/norwegian-fake-data through release.yml.

License

MIT, copyright LVL UP AS.