1
1
mirror of https://github.com/NixOS/mobile-nixos.git synced 2024-12-16 11:43:21 +03:00
not really known
Go to file
Samuel Dionne-Riel c390bbeb6b
Merge pull request #63 from samueldr-wip/feature/better-demo
Make the demo more useful on a touch device
2019-12-05 23:53:48 -05:00
artwork artwork: Adds a wallpaper for the 19.09 era 2019-12-05 23:51:07 -05:00
bin kernel-normalize-config: don't assume -I nixpkgs 2019-10-02 00:34:05 -04:00
devices motorola-addison: Reduce size of the kernel 2019-12-04 17:39:46 -05:00
doc doc: Document new stage-1-to-2 failure reporting 2019-12-03 16:38:37 -05:00
examples/demo examples/demo: Notifications should not be focusable 2019-12-05 23:51:07 -05:00
lib imageBuilder.makeMBR: Fixes bug with gap 2019-11-21 22:26:10 -05:00
modules Merge pull request #41 from kirelagin/stage-2-adb 2019-12-04 19:35:19 -05:00
overlay seabios: build vgabios for qemu use, with custom resolution 2019-12-04 17:16:09 -05:00
profiles Adds an installer output... 2019-09-21 22:45:41 -04:00
systems rootfs: Default to growing rootfs 2019-12-03 17:32:45 -05:00
.gitignore WIP : Builds a system image using nixos. 2018-06-23 17:11:07 -04:00
default.nix default.nix: Allows composition 2019-09-24 23:00:02 -04:00
LICENSE Create LICENSE 2019-05-08 16:27:21 -04:00
README.adoc README.md -> README.adoc 2019-11-15 22:02:10 -05:00
shell.nix Added additional development tools 2019-10-27 00:45:47 +10:00

= Mobile NixOS

*This is expected to be built against the nixos-unstable for now.*


== 2-minutes startup

For an already bootloader-unlocked Android-based, `fastboot`-using device.

```
# Build a boot image
nix-build --argstr device $DEVICE -A build.android-bootimg

# Reboot the phone to fastboot
adb wait-for-device && adb reboot bootloader

# Use fastboot to boot the produced image
fastboot boot result
```

=== Booting qemu

The qemu target has a `vm` build output, which results in a script that will
automatically start the "virtual device".

```
# Build the system
nix-build --argstr device qemu-x86_64 -A build.vm

# Run the VM, using the script
./result
```

=== `local.nix`

This file is used to work on producing build artifacts from the "WIP" repository
checkout. This is equivalent to adding settings in `configuration.nix`.

If the file does not exist, it will not fail.

A sample `local.nix`:

```
{ lib, ... }:

{
  mobile.boot.stage-1.splash.enable = false;
}
```

This will disable splash screens.

Note that this can be set to another file with `<mobile-nixos-configuration>`.
By setting it to the path of a nix expression, it will be used instead of using
`local.nix`.

This is the current mechanism expected to be used to create special builds using
the mobile-nixos tooling (e.g. to create a custom special `boot.img`).


== Goals

The goal is to get a NixOS system running on mobile devices, e.g. Android phones.

This is intended as building blocks, allowing the end-users to configure their
systems as desired.

The amount of targeted devices does not dilute or devalue the work. It's the
other way around, it increases the odds that people will start using the project
and contribute back.


== Prior work

This project initially borrowed and relied on the hard work from the
link:https://postmarketos.org/[PostmarketOS project]. They are forever
thanked in their efforts.