Skip to content
m4bwav edited this page Sep 28, 2026 · 1 revision

RandomNameGeneratorLibrary generates random people's names and US place names from Census lists, and the names of real stars. It is one NuGet package with no dependencies and no network calls, for any .NET from Framework 4.6.2 to .NET 10.

dotnet add package RandomNameGeneratorLibrary
using RandomNameGeneratorLibrary;

var people = new PersonNameGenerator();
var places = new PlaceNameGenerator();
var stars = new StarNameGenerator();

Console.WriteLine(people.GenerateRandomFirstAndLastName()); // for example "Deneen Vanvolkinburg"
Console.WriteLine(places.GenerateRandomPlaceName());        // for example "Prophetstown"
Console.WriteLine(stars.GenerateRandomStarName());          // for example "Alpha Muscae"

Pages

  • Getting started: install it in a project, a script, F#, PowerShell or Unity, and make the first call.
  • API reference: every public type and member, with what it returns and throws.
  • Recipes: seeded test data, dependency injection, distinct names, usernames, filtering the lists, bulk output, CSV files.
  • Reproducible names: how seeds work, what stays the same across runtimes and versions, and how each method draws from Random.
  • Name lists and data sources: where the names come from, how many there are and what was done to them.
  • Versions and upgrading: every release, and what to expect when moving from 1.2.2.
  • FAQ: repeated names on .NET Framework, odd names, gender odds, accents, size, thread safety.
  • Development: building, the tests, the golden contract, rebuilding the lists and releasing.

Elsewhere

The current version is 2.3.0 (2026-09-28). The library is MIT licensed; the IAU star names are Creative Commons Attribution, see Name lists and data sources.

Clone this wiki locally