Franky

Python Version from PEP 621 TOML GitHub License OS support downloads

A GitHub-Dark-inspired coding palette fused with the UI flavor of Catppuccin-Mocha. Franky works well alongside Catppuccin dark themes when the former are not available for a given application.

Preview

Franky

Installation

Franky comes with a Python installer. The preferred way to install the CLI is using UV:

uv tool install franky-theme

Alternatively, you can use PIPX:

pipx install franky-theme

Usage

Most themes are simple config files generated on demand by the CLI and installed in preconfigured locations. Some themes — like IPython — have a specific installation procedure.

$ franky install ghostty

Terminal

IPython Theme

Franky-IPython theme is available as an extension on PyPi. IPython typically stores its configurations in the ~/.ipython directory. One way to provide this theme to IPython is by installing this extension under ~/.ipython/extensions/. This can be done with UV as follows:

uv pip install --target="$HOME/.ipython/extensions" franky-ipython

Then add the following lines to ~/.ipython/profile_default/ipython_config.py:

import sys
from pathlib import Path

sys.path.append(str(Path.home() / ".ipython" / "extensions"))
c.InteractiveShellApp.extensions.append("franky_ipython")

ipython

Themes Roadmap

Bat
Delta
Diffnav (supported via Delta)
Ghostty
Helix editor
IPython shell
Kitty
Lazygit
Qman
Yazi
OpenCode
Neovim
Emacs
Zed
VsCode
Gtk.SourceView
shell: LS_COLORS + man colors + ncurse colors
Tmux
Zellij
Glow
CSS
Gnome Shell

Contributing

Contributors are always welcome. Feel free to grab an issue to work on or make a suggested improvement. If you wish to contribute, please read the Contribution Guide and Code of Conduct.

License

Use of this repository is authorized under the GPL-3.0.

Metadata

Release files for franky-theme 2.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for franky-theme 2.3.0
File	Size	Uploaded
franky_theme-2.3.0.tar.gz	72.1 kB	Jul 21, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for franky-theme 2.3.0
File	Interpreter	ABI	Platform	Reset
franky_theme-2.3.0-py3-none-any.whl 51.2 kB Jul 21, 2026	Python 3	none	any	Details

Total release size: 123.3 kB

Release files / franky_theme-2.3.0.tar.gz

Download URL	franky_theme-2.3.0.tar.gz
Size	72.1 kB
Tags	Source
SHA-256 checksum How to use checksums	`c031273426467a507b2d3403278f2df3380bd9daff01c152df29da3cfb7a2843`
BLAKE2b-256 checksum How to use checksums	`8c0b5572101a9b8b57581b1aab6276b2b7edea1177cf91936ae3f58fa9444da5`
Upload date	Jul 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / franky_theme-2.3.0-py3-none-any.whl

Download URL	franky_theme-2.3.0-py3-none-any.whl
Size	51.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f08bfdef6f2009be117e45178926151f1a2cdc38df0742d946b012b93421be41`
BLAKE2b-256 checksum How to use checksums	`b1a9dba294402d6f6709c8d463bda855197e7243ed069ca591020d7d7290b0c7`
Upload date	Jul 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`