Spicetify-Nix - Revision history

Nyxar77: fixed the error for nix-darwin

2025-08-14T20:43:15Z

fixed the error for nix-darwin

← Older revision		Revision as of 20:43, 14 August 2025
Line 27:		Line 27:
	inputs.spicetify-nix.homeManagerModules.default		inputs.spicetify-nix.homeManagerModules.default
	# For nix-darwin		# For nix-darwin
	inputs.spicetify-nix.~~homeManagerModules~~.default		inputs.spicetify-nix.darwinModules.default
	];		];
	</syntaxhighlight>		</syntaxhighlight>

Qweered: Modern version

2025-07-30T02:33:25Z

Modern version

← Older revision		Revision as of 02:33, 30 July 2025
Line 35:		Line 35:
	<syntaxhighlight lang="nix">programs.spicetify =		<syntaxhighlight lang="nix">programs.spicetify =
	let		let
	spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.system};		spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.stdenv.hostPlatform.system};
	in		in
	{		{
Line 46:		Line 46:
	programs.spicetify =		programs.spicetify =
	let		let
	spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.system};		spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.stdenv.hostPlatform.system};
	in		in
	{		{

Pigs: Add category desktop

2025-05-18T17:19:56Z

Add category desktop

← Older revision		Revision as of 17:19, 18 May 2025
Line 129:		Line 129:
	# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md		# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md
	# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md		# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md

			[[Category:Desktop]]

SigmaSquadron: Backlink to Spotify

2025-05-13T22:18:15Z

Backlink to Spotify

← Older revision		Revision as of 22:18, 13 May 2025
Line 10:		Line 10:
	</div>		</div>

	[https://github.com/Gerg-L/spicetify-nix/ Spicetify-Nix] is a comprehensive repository designed to integrate Spicetify with the Nix package manager and NixOS. This repository offers a Nix package and NixOS module for Spicetify, simplifying the installation and configuration process on NixOS systems. It supports various themes, extensions, and customizations to improve the Spotify user experience. The NixOS module provides predefined options and parameters, ensuring a straightforward setup.		[https://github.com/Gerg-L/spicetify-nix/ Spicetify-Nix] is a comprehensive repository designed to integrate Spicetify with the Nix package manager and NixOS. This repository offers a Nix package and NixOS module for Spicetify, simplifying the installation and configuration process on NixOS systems. It supports various themes, extensions, and customizations to improve the [[Spotify]] user experience. The NixOS module provides predefined options and parameters, ensuring a straightforward setup.

	== Installation ==		== Installation ==

SigmaSquadron: Dark mode support

2025-04-17T17:53:48Z

Dark mode support

← Older revision		Revision as of 17:53, 17 April 2025
Line 1:		Line 1:
	<div style="border: 1px solid ~~#295BC6~~; background: ~~#DEE9FF~~; padding: 30px; border-radius: 5px; margin: 10px 0px; display: flex; align-items: center;">		<div style="border: 1px solid var(--color-progressive--hover); background: var(--background-color-progressive-subtle); padding: 30px; border-radius: 5px; margin: 10px 0px; display: flex; align-items: center;">
	<div style="color: ~~#295BC6~~; font-size: 40px; margin-right: 15px; background: ~~#DEE9FF~~; display: flex; line-height: 0; align-items: center;">❄</div>		<div style="color: var(--color-progressive--hover); font-size: 40px; margin-right: 15px; background: var(--background-color-progressive-subtle); display: flex; line-height: 0; align-items: center;">❄</div>
	<div style="color: ~~#295BC6~~; font-size: 15px; font-style: normal; font-weight: 400; line-height: normal; text-align: left;">This guide requires an understanding of flakes.</div>		<div style="color: var(--color-progressive--hover); font-size: 15px; font-style: normal; font-weight: 400; line-height: normal; text-align: left;">This guide requires an understanding of [[Flakes\|flakes]].</div>
	</div>		</div>

	<div style="border: 1px solid ~~#6A0DAD~~; background: ~~#F0E6FA~~; padding: 15px; border-radius: 5px; margin: 10px 0px; display: flex; justify-content: space-between; align-items: center;">		<div style="border: 1px solid var(--color-content-added); background: var(--background-color-success-subtle); padding: 15px; border-radius: 5px; margin: 10px 0px; display: flex; justify-content: space-between; align-items: center;">
	<div style="color: ~~#6A0DAD~~; font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: left;">[https://spotify.com/ Spotify]</div>		<div style="color: var(--color-content-added); font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: left;">[https://spotify.com/ Spotify]</div>
	<div style="color: ~~#6A0DAD~~; font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: center;">[https://wiki.nixos.org/wiki/Unfree_software#Using_unfree_packages/ License: Unfree]</div>		<div style="color: var(--color-content-added); font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: center;">[https://wiki.nixos.org/wiki/Unfree_software#Using_unfree_packages/ License: Unfree]</div>
	<div style="color: ~~#6A0DAD~~; font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: right;">[https://www.spotify.com/legal/end-user-agreement/ Terms of Service]</div>		<div style="color: var(--color-content-added); font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: right;">[https://www.spotify.com/legal/end-user-agreement/ Terms of Service]</div>
	</div>		</div>

Gerg-L: Remove reference to delete file, remove suggestion to follow nixpkgs

2025-03-25T01:07:41Z

Remove reference to delete file, remove suggestion to follow nixpkgs

← Older revision		Revision as of 01:07, 25 March 2025
Line 17:		Line 17:
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">
	spicetify-nix.url = "github:Gerg-L/spicetify-nix";		spicetify-nix.url = "github:Gerg-L/spicetify-nix";
	~~spicetify-nix.inputs.nixpkgs.follows = "nixpkgs";~~
	</syntaxhighlight>		</syntaxhighlight>

Line 26:		Line 25:
	inputs.spicetify-nix.nixosModules.default		inputs.spicetify-nix.nixosModules.default
	# For home-manager		# For home-manager
			inputs.spicetify-nix.homeManagerModules.default
			# For nix-darwin
	inputs.spicetify-nix.homeManagerModules.default		inputs.spicetify-nix.homeManagerModules.default
	];		];
Line 32:		Line 33:
	== Configuration ==		== Configuration ==
	==== Basic ====		==== Basic ====
	<syntaxhighlight lang="nix">		<syntaxhighlight lang="nix">programs.spicetify =
	programs.spicetify =
	let		let
	spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.system};		spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.system};
Line 40:		Line 40:
	enable = true;		enable = true;
	theme = spicePkgs.themes.catppuccin;		theme = spicePkgs.themes.catppuccin;
	}		}</syntaxhighlight>
	</syntaxhighlight>

	==== Advanced ====		==== Advanced ====
Line 73:		Line 72:
	== Tips and Tricks ==		== Tips and Tricks ==
	==== Location of Options ====		==== Location of Options ====
	The options are found in the ~~module:~~ [https://github.~~com/Gerg-L~~/spicetify-nix/~~blob/master/module~~.~~nix module.nix~~].		The options are found in the [https://gerg-l.github.io/spicetify-nix/options.html rendered docs].

	The extensions, customApps, and themes are found in the following files: [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md EXTENSIONS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md CUSTOMAPPS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md THEMES.md].		The extensions, customApps, and themes are found in the following files: [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md EXTENSIONS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md CUSTOMAPPS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md THEMES.md].
Line 126:		Line 125:
	# https://github.com/Gerg-L/spicetify-nix		# https://github.com/Gerg-L/spicetify-nix
	# https://www.spotify.com/legal/end-user-agreement		# https://www.spotify.com/legal/end-user-agreement
	# https://github.~~com/Gerg-L~~/spicetify-nix/~~blob/master/module~~.~~nix~~		# https://gerg-l.github.io/spicetify-nix/options.html
	# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md		# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md
	# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md		# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md
	# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md		# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md

Martials: /* Advanced */Changed snippet to use camelCase instead of snake-case. https://github.com/Gerg-L/spicetify-nix/issues/218#issuecomment-2280847169

2025-01-02T18:39:32Z

Advanced: Changed snippet to use camelCase instead of snake-case. https://github.com/Gerg-L/spicetify-nix/issues/218#issuecomment-2280847169

← Older revision		Revision as of 18:39, 2 January 2025
Line 62:		Line 62:
	];		];
	enabledSnippets = with spicePkgs.snippets; [		enabledSnippets = with spicePkgs.snippets; [
	~~rotating-coverart~~		rotatingCoverart
	pointer		pointer
	];		];

Layer-09 at 19:57, 7 July 2024

2024-07-07T19:57:57Z

← Older revision		Revision as of 19:57, 7 July 2024
Line 117:		Line 117:
	overwriteAssets = false;		overwriteAssets = false;
	additonalCss = "";		additonalCss = "";
	}		};
	</syntaxhighlight>		</syntaxhighlight>

Layer-09 at 19:56, 7 July 2024

2024-07-07T19:56:16Z

← Older revision		Revision as of 19:56, 7 July 2024
Line 75:		Line 75:
	The options are found in the module: [https://github.com/Gerg-L/spicetify-nix/blob/master/module.nix module.nix].		The options are found in the module: [https://github.com/Gerg-L/spicetify-nix/blob/master/module.nix module.nix].

	The extensions, customApps, and themes are found in the following files: [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md EXTENSIONS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md CUSTOMAPPS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md THEMES.md]		The extensions, customApps, and themes are found in the following files: [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md EXTENSIONS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md CUSTOMAPPS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md THEMES.md].

	==== Unpackaged Parameters ====		==== Unpackaged Parameters ====

Layer-09: Created page for spicetify-nix

2024-07-07T19:42:42Z

Created page for spicetify-nix

New page

<div style="border: 1px solid #295BC6; background: #DEE9FF; padding: 30px; border-radius: 5px; margin: 10px 0px; display: flex; align-items: center;">
<div style="color: #295BC6; font-size: 40px; margin-right: 15px; background: #DEE9FF; display: flex; line-height: 0; align-items: center;">❄</div>
<div style="color: #295BC6; font-size: 15px; font-style: normal; font-weight: 400; line-height: normal; text-align: left;">This guide requires an understanding of flakes.</div>
</div>

<div style="border: 1px solid #6A0DAD; background: #F0E6FA; padding: 15px; border-radius: 5px; margin: 10px 0px; display: flex; justify-content: space-between; align-items: center;">
<div style="color: #6A0DAD; font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: left;">[https://spotify.com/ Spotify]</div>
<div style="color: #6A0DAD; font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: center;">[https://wiki.nixos.org/wiki/Unfree_software#Using_unfree_packages/ License: Unfree]</div>
<div style="color: #6A0DAD; font-size: 14px; font-style: normal; font-weight: 400; line-height: normal; text-align: right;">[https://www.spotify.com/legal/end-user-agreement/ Terms of Service]</div>
</div>

[https://github.com/Gerg-L/spicetify-nix/ Spicetify-Nix] is a comprehensive repository designed to integrate Spicetify with the Nix package manager and NixOS. This repository offers a Nix package and NixOS module for Spicetify, simplifying the installation and configuration process on NixOS systems. It supports various themes, extensions, and customizations to improve the Spotify user experience. The NixOS module provides predefined options and parameters, ensuring a straightforward setup.

== Installation ==
==== Using flakes ====
Include the following input in your <strong>flake.nix</strong> file.
<syntaxhighlight lang="nix">
spicetify-nix.url = "github:Gerg-L/spicetify-nix";
spicetify-nix.inputs.nixpkgs.follows = "nixpkgs";
</syntaxhighlight>

Afterwards, import the module depending on your use of global or home configuration.
<syntaxhighlight lang="nix">
imports = [
# For NixOS
inputs.spicetify-nix.nixosModules.default
# For home-manager
inputs.spicetify-nix.homeManagerModules.default
];
</syntaxhighlight>

== Configuration ==
==== Basic ====
<syntaxhighlight lang="nix">
programs.spicetify =
let
spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.system};
in
{
enable = true;
theme = spicePkgs.themes.catppuccin;
}
</syntaxhighlight>

==== Advanced ====
<syntaxhighlight lang="nix">
programs.spicetify =
let
spicePkgs = inputs.spicetify-nix.legacyPackages.${pkgs.system};
in
{
enable = true;

enabledExtensions = with spicePkgs.extensions; [
adblock
hidePodcasts
shuffle # shuffle+ (special characters are sanitized out of extension names)
];
enabledCustomApps = with spicePkgs.apps; [
newReleases
ncsVisualizer
];
enabledSnippets = with spicePkgs.snippets; [
rotating-coverart
pointer
];

theme = spicePkgs.themes.catppuccin;
colorScheme = "mocha";
}
</syntaxhighlight>

== Tips and Tricks ==
==== Location of Options ====
The options are found in the module: [https://github.com/Gerg-L/spicetify-nix/blob/master/module.nix module.nix].

The extensions, customApps, and themes are found in the following files: [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md EXTENSIONS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md CUSTOMAPPS.md], [https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md THEMES.md]

==== Unpackaged Parameters ====
Below are instructions on how to package <strong>customApps</strong> that are not in the module by default.
<syntaxhighlight lang="nix">
programs.spicetify.enabledCustomApps= [
({
# The source of the customApp
src = pkgs.fetchFromGitHub {
owner = "";
repo = "";
rev = "";
hash = "";
};
# The actual file name of the customApp usually ends with .js
name = "";
})
];
</syntaxhighlight>
Keep in mind that this can be applied to the other parameters as well. A custom theme allows for more options to be applied.
<syntaxhighlight lang="nix">
programs.spicetify.theme = {
# Name of the theme
name = "";
# The source of the theme
src = pkgs.fetchFromGitHub {
owner = "";
repo = "";
rev = "";
hash = "";
};

# Additional theme options all set to defaults
# the docs of the theme should say which of these
# if any you have to change
injectCss = true;
injectThemeJs = true;
replaceColors = true;
sidebarConfig = true;
homeConfig = true;
overwriteAssets = false;
additonalCss = "";
}
</syntaxhighlight>

== Troubleshooting ==

== References ==
# https://spotify.com
# https://github.com/Gerg-L/spicetify-nix
# https://www.spotify.com/legal/end-user-agreement
# https://github.com/Gerg-L/spicetify-nix/blob/master/module.nix
# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/EXTENSIONS.md
# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/CUSTOMAPPS.md
# https://github.com/Gerg-L/spicetify-nix/blob/master/docs/THEMES.md