A command-line tool to fetch definitions from Urban Dictionary directly from your terminal.
udict is a simple and efficient tool for getting definitions from Urban Dictionary, with styled output for easy
reading.
- Go 1.25 or later is required.
You can install udict directly using go install:
go install github.com/ty-cs/udict@latestTo build the project, clone the repository and run the following command from the root directory:
go buildAfter building, you can run the application using:
udict [command] [flags]Alternatively, you can run it without building using:
go run main.go [command] [flags]Fetches definitions for a given word from Urban Dictionary.
Flags:
-l,--limit: The number of definitions to display (up to 5).
Example:
udict define --limit 3 "gemini"Fetches definitions for a random word from Urban Dictionary.
Example:
udict randomDisplays the version of the udict tool.
Example:
udict version- Urban Dictionary Definitions: The
definecommand fetches definitions for a specified word. - Random Words: The
randomcommand provides definitions for a random word. - Styled Output: The output is styled using
lipglossfor better readability. - Customizable Definition Limit: The
definecommand allows you to limit the number of definitions displayed.
- Cobra: A popular library for creating powerful and modern CLI applications in Go.
- Lipgloss: A library for styling terminal output.
Contributions are welcome! Please feel free to submit a pull request or open an issue.
This project is licensed under the MIT License - see the LICENSE file for details.