Calibre: Difference between revisions

← Older edit

VisualWikitext

@@ Line 1: / Line 1: @@
 [https://calibre-ebook.com/ Calibre] is program to view, edit, convert and print ebooks.
-== Usage ==
+== Installation ==
+Calibre is available in [[nixpkgs]] as {{nixos:package|calibre}}.
+=== Testing ===
+You can test Calibre without installing it by using a nix shell.
+==== Flakes ====
+If you have [[flakes]] enabled, you can run this command to enter a temporary shell with Calibre available:
+<syntaxhighlight lang="bash">
+nix shell nixpkgs#calibre
+</syntaxhighlight>
+==== Non-flakes ====
+Without flakes, use this command to open a temporary shell with Calibre available:
+<syntaxhighlight lang="bash">
+nix-shell -p calibre
+</syntaxhighlight>
+=== NixOS ===
+Add the package to your NixOS configuration, in {{nixos:option|environment.systemPackages}}:
+<syntaxhighlight lang="nix">
+environment.systemPackages = with pkgs; [
+  calibre
+];
+</syntaxhighlight>
+=== Home Manager ===
+Add the package to your <code>[https://home-manager-options.extranix.com/?release=master&query=home.packages home.packages]</code>:
+<syntaxhighlight lang="nix">
+home.packages = with pkgs; [
+  calibre
+];
+</syntaxhighlight>
+== Extras ==
 === Connecting USB devices ===
@@ Line 10: / Line 56: @@
 </syntaxhighlight>
-=== <code>.cbr</code> files ===
+=== Opening <code>.cbr</code> files ===
-If you want to open <code>.cbr</code> files, you need to add the following lines to your NixOS configuration:
+<code>.cbr</code> files are comic book archives in the [[Wikipedia:RAR_(file_format)|RAR]] archive format.
+If you want to open <code>.cbr</code> files, replace <code>calibre</code> with the following in your NixOS or Home Manager configuration:
 <syntaxhighlight lang="nix">
-environment.systemPackages = with pkgs; [
+(calibre.override {
-  (calibre.override {
+  unrarSupport = true;
-    unrarSupport = true;
+})
-  })
-];
 </syntaxhighlight>
-{{note|<code>calibre</code> requires several unfree packages to open .cbr files. If you are using <code>allowUnfreePredicate</code> you will need to ensure that your configurations permit all of them.
+{{note|<code>calibre</code> requires {{nixos:package|unrar}} to open .cbr files, which is an unfree package. This also causes <code>calibre</code> to be marked as unfree. If you are using [https://nixos.org/manual/nixpkgs/unstable/#sec-allow-unfree <code>allowUnfreePredicate</code>] you will need to ensure that your configurations permit all of them.
+For example, you can add this snippet to your NixOS configuration to allow <code>calibre</code> and <code>unrar</code>.
 <syntaxhighlight lang="nix">
-{
+nixpkgs.config.allowUnfreePredicate = pkg: builtins.elem (lib.getName pkg) [
-  nixpkgs.config.allowUnfreePredicate = pkg: builtins.elem (lib.getName pkg) [
+  "calibre"
-    "calibre"
+  "unrar"
-    "unrar"
+];
-  ];
-}
 </syntaxhighlight>
 }}
+== See also ==
+* [[Wikipedia:Calibre|Calibre on Wikipedia]]
 [[Category: Applications]]