Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
thiagokokada committed Oct 24, 2023
1 parent 8e6aff8 commit 8612fff
Showing 1 changed file with 13 additions and 2 deletions.
15 changes: 13 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,13 @@ If your binary is located in `~/myapp`, run:
```console
$ nix --extra-experimental-features "nix-command flakes" run github:thiagokokada/nix-alien -- ~/myapp
```
_Tip_: if you are trying to run an OpenGL binary (e.g.: `blender`) in non-NixOS
systems, you can wrap the command above in
[nixGL](https://github.com/guibou/nixGL):

```console
$ nix --extra-experimental-features "nix-command flakes" run --impure github:guibou/nixGL --override-input nixpkgs nixpkgs/nixos-unstable -- nix run github:thiagokokada/nix-alien -- blender
```

## Usage

Expand All @@ -57,7 +64,7 @@ In case you're using [`nix-ld`](https://github.com/Mic92/nix-ld), there is also
`nix-alien-ld`:

```console
$ nix-alien-ld -- ~/myapp
$ nix-alien-ld -- ~/myapp
```

This will spawn a wrapped binary with `NIX_LD_LIBRARY_PATH` and `NIX_LD` setup.
Expand All @@ -77,7 +84,7 @@ If you want to use the `fzf` based menu to find the libraries for scripting
purposes, you can run:

```console
$ nix-alien-find-libs ~/myapp
$ nix-alien-find-libs ~/myapp
```

This will print the found libraries on the `stdout`. The informational messages
Expand Down Expand Up @@ -171,6 +178,10 @@ file.

### NixOS installation with Flakes

> :warning: Overriding nix-alien inputs may cause mismatches between the
> `nix-index-database` and `nixpkgs`, causing possibly incorrect results, so it
> is unsupported.
If you're using NixOS with Flakes, you can do something similar to your NixOS
setup to install `nix-alien` on system `PATH`:

Expand Down

0 comments on commit 8612fff

Please sign in to comment.