A CLI for all your memes.
Installation:
Note: We reccomend to install it via UV. However, you can install it any way you want.
- Install UV
- Install memer as a tool:
uv tool install --from git+https://github.com/zaremb/memer memer
- (Optional) Pull default meme templates:
memer templates pull --defaults
- Create memes, for example:
memer create --template-name "This Little Maneuver" --bottom-text "THIS LITTLE MANEUVER IS GONNA COST US 1337 COMMITS"
Usage:
$ memer [OPTIONS] COMMAND [ARGS]...
Options:
-v, --verbose
: Enable debug mode--install-completion
: Install completion for the current shell.--show-completion
: Show completion for the current shell, to copy it or customize the installation.--help
: Show this message and exit.
Commands:
create
: Create a meme using the specified template...config
: Configuration related commands.templates
: Meme template related commands.
Create a meme using the specified template and text options.
Usage:
$ memer create [OPTIONS]
Options:
-n, --template-name TEXT
: The name of the meme template to use. If provided name is a path, it will be used as a template. [required]-t, --top-text TEXT
: The text to display at the top of the meme.-b, --bottom-text TEXT
: The text to display at the bottom of the meme.-o, --output-path PATH
: The path where the generated meme will be saved.--help
: Show this message and exit.
Configuration related commands.
Usage:
$ memer config [OPTIONS] COMMAND [ARGS]...
Options:
--help
: Show this message and exit.
Commands:
show
: Logs the configuration.path
: Shows the path to the configuration.edit
: Opens the configuration in the default...
Logs the configuration.
Usage:
$ memer config show [OPTIONS]
Options:
--help
: Show this message and exit.
Shows the path to the configuration.
Usage:
$ memer config path [OPTIONS]
Options:
--help
: Show this message and exit.
Opens the configuration in the default editor.
Usage:
$ memer config edit [OPTIONS]
Options:
--help
: Show this message and exit.
Meme template related commands.
Usage:
$ memer templates [OPTIONS] COMMAND [ARGS]...
Options:
--help
: Show this message and exit.
Commands:
list
: Lists the available templates.search
: Searches for templates that match the...pull
: Pulls meme templates from various sources...
Lists the available templates.
Args: verbose (bool): If True, enables verbose output which includes the template's name, path, and key. If False, only the template's name is displayed.
Returns: None
Usage:
$ memer templates list [OPTIONS]
Options:
-v, --verbose
: Enable verbose output--help
: Show this message and exit.
Searches for templates that match the given phrase and prints the results.
Args: phrase (str): The phrase to search for in the template names.
Returns: None
Usage:
$ memer templates search [OPTIONS] PHRASE
Arguments:
PHRASE
: [required]
Options:
--help
: Show this message and exit.
Pulls meme templates from various sources and saves them to the user data template path.
Parameters: url (str | None): The URL of the meme template to pull. Specified with --url or -u option. name (str | None): The name to assign to the pulled meme template. Specified with --name or -n option. from_file (Path | None): The path to a file containing URLs of meme templates to pull Specified with --from-file or -f option. defaults (bool): Flag to pull default meme templates. Specified with --defaults or -d option.
Usage:
$ memer templates pull [OPTIONS]
Options:
-u, --url TEXT
-n, --name TEXT
-f, --from-file PATH
-d, --defaults
--help
: Show this message and exit.