diff --git a/app-misc/spicetify-cli/Manifest b/app-misc/spicetify-cli/Manifest
index a80d8b2..cc99aa5 100644
--- a/app-misc/spicetify-cli/Manifest
+++ b/app-misc/spicetify-cli/Manifest
@@ -6,3 +6,5 @@ DIST spicetify-cli-2.29.1-deps.tar.xz 5167956 BLAKE2B a372f94aee08ba24c3580624ea
 DIST spicetify-cli-2.29.1.tar.gz 2042773 BLAKE2B 8a0e7833fa4183eb689d0b451391a79569a60265e74c45871f7af1575cf340190da614e63421939506a52b79b2c18ef8b5d4eed0b4d37d219f99112e12c1435e SHA512 e23f53e8db009a9cac22b57c50542acbb5a9aa212b055354bcf11a85743d2c9f5aabcdac1abb9bd8f6ccacb45792f40813e30cd179fe01d7653e31c50b675759
 DIST spicetify-cli-2.30.0-deps.tar.xz 5177060 BLAKE2B a540c5cd77c9343ba53d8838cf5b0a79b2bdddf6bdcc2b49e631f93e345f3d84f03d74d23d9cbe68d04efb0f2c4419e98dff16d13477d28b55858745129931c6 SHA512 3262ff75b05375cc5531fd52b7815b935037caf1bfeec0c4a8c2a904bcf8310917c86cde2eccf849e1bf5d5525434050293414855a5130e1103aa9a77491864b
 DIST spicetify-cli-2.30.0.tar.gz 2011152 BLAKE2B 6e0e2153bef7aa52d44e00c6d3c54293ca000fd8ad2290fd7209ed4de1b6f3bbe3d860e120aa42cfe569eeb6163aaf1e5d2870427224b57e5c0cc7248c06f429 SHA512 f9c72a78a574dccae6e73ae3d798a1670be31972baf80750d1ade2933aa0694ed1fd6dd427f2f57842765f305cbe5f7e71f805f40df6e89e115315d9c607e3b9
+DIST spicetify-cli-2.31.0-deps.tar.xz 5177792 BLAKE2B 1cfc1c659e2f5eb337e232a83b3e1619f9ebfa4c48a5b0a0d374eecaadca33f255badb81860e7817ce9d40a7e29fd30700fc2c548074166ef6f4022a979bb509 SHA512 2f824304d9e539b967a987c7d802d6979030befdf28ab395dd2da5d7142c0aeff1dfd138ae61edc7510fb2aa01e62488d14e6c5229331b51bc9d1811b52a8f57
+DIST spicetify-cli-2.31.0.tar.gz 2012768 BLAKE2B 656b3d9c781371bc40d141abc977667e28f3f5366585e9706cc50188051f3973d49f5aecfbf7930d3f2f46c526ad39b1b2bdf1855aa64dff0bdee44350f08f79 SHA512 a93f757ade662d54a0f50e03ef1ecd94d20154787d57b105bffd780ca543dfb6abc644e94e0c36728ccbe3214fc723a14a9016b2d235ef5c6d024ff23e550a61
diff --git a/app-misc/spicetify-cli/spicetify-cli-2.31.0.ebuild b/app-misc/spicetify-cli/spicetify-cli-2.31.0.ebuild
new file mode 100644
index 0000000..12ad815
--- /dev/null
+++ b/app-misc/spicetify-cli/spicetify-cli-2.31.0.ebuild
@@ -0,0 +1,99 @@
+# Copyright 1999-2024 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+inherit go-module
+
+WHITELIST_VERSIONS=(
+	"<> 1.2.8 1.2.30"
+)
+
+whitelist_versions() {
+	local version_spec version1 version2
+	local -a deps
+
+	SPOTIFY_VERSIONS=
+
+	# Iterate in reverse for elog
+	for ((index = $(( ${#WHITELIST_VERSIONS[@]} - 1 )); index >= 0; index--)); do
+		read -r version_spec version1 version2 <<< "${WHITELIST_VERSIONS[${index}]}"
+
+		case ${version_spec} in
+			"<>")
+				deps[$index]="( <=media-sound/spotify-${version2} >=media-sound/spotify-${version1} )"
+				SPOTIFY_VERSIONS+="${version1} -> ${version2}"
+				;;
+			"~")
+				deps[$index]="~media-sound/spotify-${version1}"
+				SPOTIFY_VERSIONS+="${version1}"
+				;;
+			*)
+				die "Invalid version specifier in WHITELIST_VERSIONS"
+				;;
+		esac
+
+		if [[ ${index} == 0 ]]; then
+			SPOTIFY_VERSIONS+=". "
+		elif [[ ${index} == 1 ]]; then
+			SPOTIFY_VERSIONS+=" and "
+		else
+			SPOTIFY_VERSIONS+=", "
+		fi
+	done
+
+	RDEPEND=" || ( ${deps[@]} )"
+}
+whitelist_versions
+
+DESCRIPTION="Commandline tool to customize Spotify client."
+HOMEPAGE="https://spicetify.app/"
+SRC_URI="
+	https://github.com/spicetify/spicetify-cli/archive/v${PV}.tar.gz -> ${P}.tar.gz
+	https://gitlab.com/api/v4/projects/37881342/packages/generic/${PN}/${PV}/${P}-deps.tar.xz
+"
+
+LICENSE="Apache-2.0 BSD LGPL-2.1 MIT"
+SLOT="0"
+KEYWORDS="~amd64"
+
+# no tests
+RESTRICT="test"
+
+INSTALLDIR="/opt/${PN}"
+
+src_compile() {
+	ego build -ldflags "-X main.version=${PV}"
+}
+
+src_install() {
+	insinto "${INSTALLDIR}"
+	doins -r {CustomApps,Extensions,Themes,jsHelper,spicetify-cli}
+	dobin "${FILESDIR}/spicetify"
+	fperms +x "${INSTALLDIR}/spicetify-cli"
+}
+
+pkg_postinst() {
+	elog "Spicetify requires a Spotify install that it can modify."
+	elog "To give read and write permissions to everyone on the system to run the following commands as root."
+	elog "# chmod a+wr /opt/spotify/spotify-client"
+	elog "# chmod a+wr /opt/spotify/spotify-client/Apps -R"
+	elog ""
+	elog "WARNING: Do not run spicetify as root please"
+	elog ""
+	elog "Spicetify compatibility is limited to the following Spotify versions:"
+	elog " ${SPOTIFY_VERSIONS}"
+	elog ""
+	elog "Otherwise you can install spotify to a user modifiable location like as a flatpak:"
+	elog " https://spicetify.app/docs/advanced-usage/installation#spotify-installed-from-flatpak"
+	elog ""
+	elog "To install themes see:"
+	elog " https://spicetify.app/docs/advanced-usage/themes"
+
+	if $(has_version -r ">=media-sound/spotify-1.2.25"); then
+		elog ""
+		elog "The New Releases custom app no longer works with Spotify 1.2.25 and higher. As an alternative,"
+		elog "please use What's New which was created by Spotify and can be enabled via Experimental Features"
+		elog "if it isn't already enabled."
+	fi
+}