A simple and flexible random name generator for .NET, capable of creating names composed of an adjective and a noun from predefined categories. Supports customizable suffixes, separators, and output styles (lowercase, uppercase, title case). Ideal for generating usernames, project names, or other randomized identifiers.
Get Started
$ dotnet add package UniqueNamerReadme
UniqueNamer
UniqueNamer is a C# library for generating unique and memorable names (e.g., talented-toucan, naughty-watermelon). These names are ideal for naming temporary directories, user session IDs, gamer tags, project names, process names, or submitted jobs.
The library is inspired by aziele/unique-namer, originally developed by Andrzej Zielezinski. UniqueNamer expands on the concept, offering customizable name generation with a wide variety of thematic categories.
Features
- Over 17 million unique names
- Nearly infinite unique identifiers with suffix options
- 22 predefined categories
- Customizable output style and formatting
Installation
UniqueNamer is available as a NuGet package. You can install it using the NuGet Package Manager:
Install-Package UniqueNamer
Or via the .NET CLI:
dotnet add package UniqueNamer
Usage
Generating Names
The Generate method returns a unique and randomly generated name consisting of an adjective and a noun.
using UniqueNamer;
string name = UniqueNamer.Generate(new[] { Categories.Animals });
Console.WriteLine(name); // Example: 'blushy-cyclist'
Customizing Names
Choosing Categories
The Generate method allows specifying categories to influence the type of generated names:
string name = UniqueNamer.Generate(new[] { Categories.Astronomy });
Console.WriteLine(name); // Example: 'crazy-supernova'
To select multiple categories:
string name = UniqueNamer.Generate(new[] { Categories.Physics, Categories.Biology });
Console.WriteLine(name); // Example: 'pink-bacteria'
Adding a Unique Suffix
The suffixLength parameter adds a random alphanumeric suffix to create a unique identifier:
string name = UniqueNamer.Generate(new[] { Categories.History }, suffixLength: 3);
Console.WriteLine(name); // Example: 'annoying-cleopatra-9a1'
Customizing Separators
Change the separator between name components:
string name = UniqueNamer.Generate(new[] { Categories.Sports }, separator: "_");
Console.WriteLine(name); // Example: 'savage_judo'
Formatting Styles
The Style enum lets you choose different text case formats:
string name = UniqueNamer.Generate(new[] { Categories.Food }, style: Style.UPPERCASE);
Console.WriteLine(name); // Example: 'DAMAGED-ELECTRON'
string nameTitle = UniqueNamer.Generate(new[] { Categories.Music }, separator: " ", style: Style.TitleCase);
Console.WriteLine(nameTitle); // Example: 'Lazy Unicorn'
Categories
UniqueNamer provides predefined categories to tailor generated names. Some available categories include:
AnimalsArtAstronomyBiologyChemistryComputerScienceEconomyFoodGeographyHistoryLiteratureMathMedicineMicrobiologyMolecularBiologyMusicPhysicsPlantsScientistsSportsTechnology
License
This project is licensed under the MIT License.