File: macOS.md

package info (click to toggle)
pdfarranger 1.13.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,356 kB
  • sloc: python: 7,573; xml: 237; sh: 39; makefile: 2
file content (42 lines) | stat: -rw-r--r-- 1,758 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
# PDF Arranger on macOS

## Run with Nix  

To use pdfarranger on macOS, is suggested to use [Nix](https://nixos.org/), which already provides [pdfarranger package](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/pd/pdfarranger/package.nix). 

### Install Nix on macOS

If this is your first time using Nix on macOS, it's recommended to use [Determinate Nix Installer](https://github.com/DeterminateSystems/nix-installer). Just type this one-liner command in terminal:  
```
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
```

Instead of [Determinate Nix Installer](https://github.com/DeterminateSystems/nix-installer), you can also use [Official Nix Installer](https://nixos.org/download/#nix-install-macos):  
```
sh <(curl -L https://nixos.org/nix/install)
```

### Run pdfarranger Ad hoc
After installation, run `nix-shell -p pdfarranger --run pdfarranger` in terminal to launch pdfarranger. Nix will download pdfarranger and its dependencies to `/nix`.

### Add pdfarranger to Applications
You may consider set up [nix-darwin](https://github.com/LnL7/nix-darwin).

## Run pdfarranger manually
If you want to run pdfarranger without nix, you can install dependencies manually ([Homebrew](https://brew.sh/) / [MacPort](https://www.macports.org/) / etc.). 

You'll need
1. [GTK3](https://docs.gtk.org/gtk3/)  
2. [gettext](https://www.gnu.org/software/gettext/)  


After installation, set two environment variables:  
1. `GSETTINGS_SCHEMA_DIR`:  The file `$GSETTINGS_SCHEMA_DIR/org.gtk.Settings.FileChooser.gschema.xml` should exist.  
2. `DYLD_LIBRARY_PATH`: The file `$DYLD_LIBRARY_PATH/libintl.8.dylib` should exist.  

Finally, you can run
```
./setup.py build
python3 -m pdfarranger
```