nyuuzyou/wikis huggingface dataset:
Apple iPhone 3G (apple-iphone3g)

== Users owning this device ==
== Booting ==
This phone is unable to boot postmarketOS as of yet.
== Installing ==
In order to run OpeniBoot, you'll need to jailbreak the phone. You can use redsn0w (proprietary) to jailbreak it, you may have to download an ipsw file. You might have to install iPhoneOS that is older than version 4.2.1 as OpeniBoot might not work with iPhoneOS 4.2.1(?), iPhoneOS 3.1.3 might work.
When the phone is jailbreaked, you can install OpeniBoot. Download OpeniBoot image and Clone the iphonelinux repo (URL TODO) to your computer, then run 
$ cd iphonelinux/openiboot/client && make 
After it has compiled successfully, plug the charger into computer, turn off your iPhone, hold down the home button and plug the charger into the phone. It should boot into iTunes recovery mode and on your computer, run 
 
# ./loadibec path/to/openiboot.img 
The phone should boot into OpeniBoot. 
On computer, type sudo ./oibc but don't run it yet. On the phone, navigate to console button with volume buttons and select with home button. Run the command you entered on your computer. If successful, you should see the same text on your computer as on the phone.
(TODO: Run pmOS kernel)
If you need help, feel free to contact dolphinana. You could also help him get Linux running :)
== See also ==
* iDroid-Project
* iDroid-Project website (Some infos might not be relevant)
* iphonelinux
* prebuilt binaries for openiboot
* iPad 1G wiki page (contains some useful info)
Apple iPhone 5s (apple-iphone5s)

A mainline fork for this device is available here with further instructions here. Still needs to be tested and ported to postmarketOS.
== Users owning this device ==
== How to enter flash mode ==
Only works on macOS right now!
1. Install checkra1n
2. Boot pongoOS: `/Applications/checkra1n.app/Contents/MacOS/checkra1n -pc`
Apple iPhone 6 (apple-n61)

The Apple iPhone 6 was an entry-level phone in the iPhone lineup. Featuring NFC, VoLTE, a hi-dpi display, fingerprint sensor, and other nice-to-haves. It also features the early aarch64 Apple A8 SOC.
Fun Fact: Contrary to the name, this is the 8th generation of iPhone.
== Contributors ==
* User:Konradybcio
* User:Ivoszbg
* User:Asutoshvariar
== Maintainer(s) ==
* User:Justsoup
== Flashing ==
You can't currently flash via pmbootstrap, but the kernel can be booted via konradybcio/PongoOS.
Follow this guide to get the starting pieces up and running. If you run into errors compiling pongoOS, remove -Werror from the Makefile's EMBEDDED_CC_FLAGS. Stop after obtaining the dtbpack.
Now, we're going to use pmbootstrap (install it if you haven't already).
Run pmbootstrap init to get ready. Use "apple" for the vendor name and "n61" for the device name.
 When choosing a username and password, write them down. They will be important later. 
Choose "none" for the user interface. Do not change the presented options. Device hostname doesn't matter, so select whatever you'd like.
Now, run
$ pmbootstrap install
$ pmbootstrap initfs hook_add netboot
$ pmbootstrap export
to retrieve the rootfs and initramfs.
Now, go back to the pongoOS directory and run:
# python3 scripts/load_linux.py -k {path to linux-apple}/arch/arm64/boot/Image.lzma -d {path to linux-apple}/dtbpack -r /tmp/postmarketOS-export/initramfs
If all goes well, you should now see the Waiting for netboot image screen.
To serve the image, run
$ pmbootstrap netboot serve
If you see a tty and a login screen, that means pmOS is working.
Now's when we use the username and password we set.
Do:
$ ssh {username}@172.16.42.1 # Enter the password when prompted
Connecting to the internet over USB is recommended.
== Users owning this device ==
== See also ==
* GSMArena page
* Apple Device Tree (adt)
* Mainline kernel fork
Apple iPhone 6s/6s+ (apple-iphone6s)

A mainline fork for this device is unavailable.
These two devices have not booted Android (via Project Sandcastle) but a postmarketOS port could be possible once the CPU is working
== Contributors ==
*
== Users owning this device ==
== How to enter flash mode ==
No proper flash mode, but kernel can be booted via checkra1n/PongoOS.
First you have to enter DFU mode.
* Power off your phone and connect it to your computer via USB
* Hold down + for 8 seconds
* Release and keep holding for another 10 seconds
The screen should stay blank if everything went good.
To enter PongoOS, from where we could load the Linux kernel, run following command on the host machine:
$ ./checkra1n -cpE
PongoOS will start booting and printing messages on the screen.
== Installation ==
There is no official way to boot pmOS yet
== See also ==
* Project Sandcastle provides the basic Linux port to Apple silicon
Apple iPhone 7/7+ (apple-iphone7)

A mainline fork for this device is available here with further instructions here. Still needs to be tested and ported to postmarketOS.
These two devices can boot Android (via Project Sandcastle) so a postmarketOS port could be possible once flash storage drivers are added.
== Contributors ==
* User:Onny
== Users owning this device ==
== How to enter flash mode ==
No proper flash mode, but kernel can be booted via checkra1n/PongoOS.
First you have to enter DFU mode.
* Power off your phone and connect it to your computer via USB
* Hold down + for 8 seconds
* Release and keep holding for another 10 seconds
The screen should stay blank if everything went good.
To enter PongoOS, from where we can load the Linux kernel, run following command on the host machine:
$ ./checkra1n -cpE
PongoOS will start booting and printing messages on the screen.
== Installation ==
There is a manual method described in this blog post.
After this pull request is merged, one could possibly boot the kernel by just running
 $ pmbootstrap flasher boot
== See also ==
* Project Sandcastle provides the basic Linux port to Apple silicon
* Initial merge request
* Device package
* Kernel package
Apple iPhone SE 2016 (apple-iphoneSE2016)

A mainline fork for this device is available here with further instructions here. Still needs to be tested and ported to postmarketOS.
== Contributors ==
== Maintainer(s) ==
== Users owning this device ==
== Installation ==
/* Not yet */
== See also ==
== Device notes ==
* the iphone SE shares the A9 Soc with the iphone 6s and 6s Plus
Apple iPod Touch 1G (apple-ipt1g)

== Contributors ==
* MartijnBraam
* opendata
== Progress ==
The iPod can boot Linux with the openiboot firmware which has to be build first. The openiboot firmware is not made for GCC6 and requires a few patches, it's also written for the arm-elf toolchain but it can be built with the arm-eabi toolchain for now which seems to work.
This is also the slowest device yet since it uses a 412 Mhz ARMv6 single-core cpu (Samsung S5L8900) and 128 MB ram. It has also has a PowerVR GPU which can cause trouble with porting.
== Links ==
* openiboot (Great info on wiki)
* iphonelinux (Also this wiki has a lot of useful info)
* iDroid-kernel (older iDroid/OpeniBoot kernel)
* Another fork of the iDroid kernel with more complete A4 support
* iphonelinux kernel, separate from the OpeniBoot project.
* pmos branch, old scheme, aports/main/openiboot would need to be copied to the new pmaports.git
Applications by category

A list of GUI applications for postmarketOS, divided into funny categories. Most of these applications work reasonably well for and mobile use. Note that you might like to read the application's wiki page to be informed about known issues and workarounds. Before adding applications to this list, please look at Applications by category:Contributing. Strongly inspired by Arch Linux Wiki's list of applications. If Alpine's package has a fork in pmaports, it is listed here.
== Internet ==
=== Web browsers ===
*
*
*
*
*
*
*
*
=== Gemini browsers ===
*
=== Communication ===
==== Email clients ====
*
*
==== Instant messenger clients ====
===== IRC =====
*
*
*
*
===== XMPP / Jabber =====
*
*
*
===== Matrix =====
*
*
*
*
*
*
*
*
*
===== SMS =====
*
===== Other protocols =====
*
*
*
*
*
*
*
=== Clients for various web services ===
*
*
*
*
*
*
*
*
*
For general information on how to use webapps, see the article on Firefox
===== Tor =====
*
=== News and RSS ===
==== Feed aggregators ====
*
*
*
=== File sharing ===
*
*
*
*
== Multimedia ==
=== Audio ===
==== Players ====
*
*
*
*
*
*
*
*
*
*
*
*
==== Podcast apps ====
*
*
*
==== Recorders ====
*
*
==== Other ====
* 
*
*
*
*
*
=== Images ===
==== Viewers / Management ====
*
*
*
*
*
*
==== Image Editors ====
*
==== Camera Apps ====
*
*
*
*
*
==== Raster graphics editors ====
*
=== Video players ===
*
*
*
*
*
*
*
==== Video Editors ====
*
=== Games ===
==== Game Hubs ====
*
*
*
*
==== Runs on software rendering ====
*
*
*
*
*
*
*
*
*
*
*
*
*
* 
==== Needs 3D Acceleration ====
*
*
==== Not tested ====
*
*
== Utilities ==
=== Terminal emulators ===
*
*
*
=== Files ===
==== File managers ====
*
*
*
*
*
*
==== Archiving and compression ====
*
*
==== Other ====
*
*
*
*
=== Time ===
==== Clocks ====
*
*
==== Task management / Calendars ====
*
*
*
*
*
*
==== Other ====
*
=== Contacts Management ===
*
*
=== System ===
==== Usage statistics / monitoring ====
*
*
*
*
*
==== Package managers ====
*
*
==== Settings ====
*
*
*
=== Disks ===
*
=== Onscreen Keyboards ===
*
*
*
*
*
*
== Documents and text ==
=== Text editors ===
*
*
*
*
*
=== Markdown ===
*
*
=== Viewers ===
*
*
*
*
*
*
=== Notes ===
*
*
*
*
=== Other ===
*
*
== Security ==
=== Password Managers ===
*
*
=== 2FA Apps ===
*
*
*
*
*
== Science ==
=== Math ===
*
*
*
*
=== Geography ===
*
*
*
*
*
*
*
*
=== Meteorology ===
*
*
== Education ==
=== Music ===
*
*
=== Languages ===
*
== Other ==
=== Public transportation ===
*
*
*
*
=== Dialers ===
*
*
=== Translators ===
*
*
*
=== Other ===
*
*
*
*
*
*
*
*
== See also ==
* :Category:Apps
* Games
* GNOME apps
* Car interface
* Applications by function, more focused on replacements for apps on other mobile OSes, and with a table for GNOME/KDE/other apps
* LinuxPhoneApps.org, selection of apps packaged for postmarketOS
* Mobile Gnu/Linux App list Unmaintained, see LinuxPhoneApps.org for a maintained fork
* Corresponding article in the PureOS wiki
* Corresponding article on the Mobian wiki
* Corresponding article in the OpenMoko wiki
Archos 80 G9 (archos-a80)

== Contributors ==
* MartijnBraam
== Device owners ==
== How to enter flash mode ==
You can enter flash mode with + or + after installing the SDE bootmenu.
== Installation ==
=== Installing SDE bootmenu ===
The first step is installing SDE bootmenu so you'll be able to actually flash non-archos software to the device. This will void your warranty!
# Power on the tablet while holding the button, release the button as soon as the archos logo shows up but hold the button.
# Choose "Update Firmware" with the and buttons and press the button to accept
# The device now shows up as an empty mass storage device, mount the device and download the SDE bootmenu image to it.
# Unmount the mass storage device and press the power button again on the device to install
=== Flashing the kernel and initramfs ===
After installing SDE bootmenu you can install the kernel and initramfs. This is also done through a mass storage device.
# Power on the tablet while holding 
# Select "Developer Edition Menu"
# The first time you flash a kernel you'll have to remove the android kernel since the bootloader will default to that kernel over your custom developer kernel.
# Select "Flash Kernel and Initramfs"
# Mount the mass storage device that just appeared
== Links ==
SDE Bootmenu installation on XDA
Archos Sense 55s (archos-ac55ses)

== Contributors ==
* Chaosleo07
== Users owning this device ==
== How to enter flash mode ==
Press and hold + Choose Fastboot mode with , then confirm with .
== Unlocking the Bootloader ==
!!!WARNING!!! 
This will reset your device to Factory settings! You have been warned. 
When in Fastboot mode, run "fastboot oem unlock" and follow the on-screen instructions
== Installation ==
/* Not yet */
== See also ==
Aspinwall

== About ==
Aspinwall is a Linux interface for tablets and touchscreen devices. It offers:
* A clean, focused launcher with a widget view - reminiscent of smart hub devices
Some level of convergence - the shell works on both vertical (portrait) and horizontal (landscape) displays
* A widget API for creating your own widgets
* (TODO) Multitasking features, such as a dedicated app list and easy window control
* (TODO) Integration with voice assistants (see our Mycroft GUI, Lapel)
== See also ==
* Project repository
* knuxify (project founder)
Category:Interface
AsteroidOS

AsteroidOS is a Linux based operating system for smartwatches. The UI it develops has been packaged for postmarketOS as well. It is based on Jolla's Mer software stack which it shares with Glacier
== Installation ==
The Asteroid UI can be installed by selecting it as UI in pmbootstrap init. On existing systems it can be installed by installing the meta package or if postmarketOS specific customization is not wanted.
When running pmbootstrap install you'll be prompted for a user password. Note that the password will only be used for SSH access to the device, as smartwatches don't use passwords to unlock the screen due to the way it's used.
== Usage ==
=== Install software ===
There currently is no software store to install new applications. Because of this software can currently only be installed on the command-line. Make sure your device is connected via USB, or to your network via Wi-Fi if your watch supports it, and SSH in. Software can then be installed with apk:
# apk add <software>
== See also ==
* AsteroidOS
* AsteroidOS source code
* Asteroid UI for handsets (video)
Asus Max M1 (asus-x00p)

== Contributors ==
* danascape
== Users owning this device ==
== How to enter flash mode ==
To enter Fastboot mode, hold Volume Up while powering on the device. Let go of Volume Up when "Fastboot mode" displays on the screen.
Alternatively, if connected to a pc then you can also use adb reboot bootloader.
== Installation ==
pmbootstrap flasher flash_rootfs
pmbootstrap flasher flash_kernel
Please note, pmbootstrap flasher boot doesn't work
== See also ==
Asus Transformer Pad (asus-tf103c)

== Contributors ==
* Eloy
== Device Owners ==
== Installation ==
=== Update to Android 5.0 ===
To get UEFI for booting postmarketOS, it is required to update to Android 5.0. First, make sure the tablet is fully charged.
If the build number is lower than WW-2.2.33.144, download UL-K010-WW-2_2_33_144-user.zip and rename it to (or in case Asus fixed it, make sure the filename is) UL-K010-WW-2.2.33.144-user.zip. Put the file in the root of the internal storage. A notification should appear which will start the update process. Make sure to charge the tablet before updating.
If the build number is equal to WW-2.2.33.144, download the Android 5.0 upgrade file UL-K010-WW-12_10_5_11-user.zip, unzip it and put the zip inside in the root of the internal storage. A notification should appear which will start the update process.
=== Install bootloader ===
* Install me176c-boot
=== Install postmarketOS ===
TODO
== Mainline kernel ==
Fedora+Xfce has been tested and boots up fine, with the use of me176c-boot and a USB-OTG hub. The Arch Linux liveiso disabled USB after roughly a minute.
Note: might be a good idea to copy ACPI tables from the T100TA, which is quite like this device.
=== Hardware status ===
Status	Hardware 	Info
Y 	Booting 	
Y 	Panel 	Panel works, unknown type. In Xfce the highest pixel row contains the lowest pixel row with some horizontal offset, cause is unknown.
N 	Touchscreen 	Atmel mXT1664T2-C2U, there is a driver in mainline but untested
Y 	USB 	USB-OTG through charging port works, secondary USB-A port in dock doesn't work because the entire dock does not work yet.
Y 	SD cards 	MicroSD cards are recognized and can be mounted
Y 	Internal memory 	Can be accessed
N 	GPS 	
N 	WiFi 	
N 	Bluetooth 	
N 	GPIO keys 	
N 	Vibro 	
N 	Dock Keyboard 	
N 	Battery/Charger 	
N 	PMIC 	
N 	Sound 	
N 	Voice processor 	
N 	Thermal sensor 	
N 	Orientation sensors 	
N 	Light sensor 	
N 	Front camera 	
N 	Rear camera 	
Y 	Intel Integrated Graphics
Asus ZenPad 7 (asus-p01z)

== Owners ==
== Contributors ==
* Eloy
* Mis012
== Bootloader unlock ==
If you can't access ADB, press + from the off-state to enter fastboot mode and skip to the last commands.
After running the first command, make sure to confirm the RSA key prompt on the device.
$ adb devices
$ adb reboot fastboot
$ sudo fastboot oem asus-go
$ sudo fastboot oem asus-go confirm
=== Rooting ===
Thanks to the 4pda community, a custom bootimage has been developed which contains a one-shot shell script that roots the device. Download the file here and run the following command while the tablet is in fastboot mode and has been unlocked already (possibly different path):
$ sudo fastboot boot root-z170c_cg.img
== Notes ==
This x86 tablet has a Mali GPU, which is quite a weird combination. The Lima driver has not yet been tested on x86.
=== Downstream kernel ===
The downstream kernel can be downloaded from Asus, see the "Drivers & Tools" tab here.
For working 3D graphics, mainline would be required, but having a port with downstream could be used in the meantime.
== Notes ==
=== /proc/cmdline ===
emmc_manfid=6 androidboot.bootloader=1715.100_M1S1 androidboot.serialno=G7NPFP046081A8H pmu_rst_src=0x00010008 pmu_shutdwn_src=0x00000000 scu_rsts=0x40008001 wifi_only_fuse=1 androidboot.mode=normal panelsource=0 console=ttyS0,115200n8 idle=halt earlyprintk=xgold notsc androidboot.hardware=sofia3g nolapic_pm firmware_class.path=/system/vendor/firmware androidboot.selinux=enforcing nolapic_timer x86_intel_xgold_timer=soctimer_only loglevel=0 slub_max_order=0 mvpipe.at_dbg_port=1 vmalloc=336M
=== /proc/version ===
Linux version 3.14.0 (android@Scorpio) (gcc version 4.6.3 (Ubuntu/Linaro 4.6.3-1ubuntu5) ) #1 SMP PREEMPT Mon Apr 10 18:48:54 CST 2017
== See also ==
* Intel MID
== External links ==
* Unlock bootloader of the P01Y, a different model
Asus ZenPad 8 (asus-p024)

== Contributors ==
* Radmir Far
== Users owning this device ==
== How to enter flash mode ==
With the device powered off, hold Volume Up + Power.
== Installation ==
$ pmbootstrap flasher flash_rootfs
$ pmbootstrap flasher flash_kernel
== What doesn't work ==
Battery level reporting seems to be broken.
== See also ==
* Initial merge request
* 
* 
* Device info on LineageOS Wiki
Asus ZenWatch 2 (asus-sparrow)

=== Contributors ===
* MartijnBraam
* z3ntu
=== Entering Fastboot mode ===
Turn on your watch and swipe from the top left corner (so that be where 11 would be on the watch) as soon as you see the ASUS logo.
== Device info ==
=== Partition info ===
Boot and recovery are 16MiB
(bootloader) partition: system, 	 ,size:	 0x20000000 	,type:	 ext4
(bootloader) partition: userdata, 	 ,size:	 0xa47fbe00 	,type:	 ext4
(bootloader) partition: cache, 	 ,size:	 0x19000000 	,type:	 ext4
(bootloader) partition: boot, 	 ,size:	 0x1000000 	,type:	 raw
(bootloader) partition: recovery, 	 ,size:	 0x1000000 	,type:	 raw
DDR -> /dev/block/mmcblk0p6
aboot -> /dev/block/mmcblk0p5
abootbak -> /dev/block/mmcblk0p10
asusdata -> /dev/block/mmcblk0p13
asusdata2 -> /dev/block/mmcblk0p14
asusfw -> /dev/block/mmcblk0p20
asusgpt -> /dev/block/mmcblk0p21
asuskey -> /dev/block/mmcblk0p15
asuskey2 -> /dev/block/mmcblk0p16
asuskey3 -> /dev/block/mmcblk0p17
asuskey4 -> /dev/block/mmcblk0p18
asuskey5 -> /dev/block/mmcblk0p19
boot -> /dev/block/mmcblk0p11
cache -> /dev/block/mmcblk0p27
misc -> /dev/block/mmcblk0p23
pad -> /dev/block/mmcblk0p12
persist -> /dev/block/mmcblk0p24
recovery -> /dev/block/mmcblk0p25
rpm -> /dev/block/mmcblk0p3
rpmbak -> /dev/block/mmcblk0p8
sbl1 -> /dev/block/mmcblk0p1
sbl1bak -> /dev/block/mmcblk0p7
sdi -> /dev/block/mmcblk0p2
ssd -> /dev/block/mmcblk0p22
system -> /dev/block/mmcblk0p28
tombstones -> /dev/block/mmcblk0p26
tz -> /dev/block/mmcblk0p4
tzbak -> /dev/block/mmcblk0p9
userdata -> /dev/block/mmcblk0p29
=== Links ===
* Kernel source
* AsteroidOS device page
Asus Zenfone 2 Laser/Selfie (1080p) (asus-z00t)

== Contributors ==
* samueldr
== Maintainer(s) ==
== Device owners ==
== How to enter flash mode ==
Volume up + power
 adb wait-for-device && adb reboot bootloader
== Installation ==
Flash via TWRP recovery.
 pip3 install --user pmbootstrap
 source ~/.profile
 sudo apt install python3-argcomplete 
 echo 'eval "$(register-python-argcomplete3 pmbootstrap)"' > ~/.bashrc
 pmbootstrap init
 Work path: default
 Channel: edge 
 Vendor: asus
 Device codename: z00t
 Username: user
 User Interface: xfce4
 pmbootstrap install --android-recovery-zip
 pmbootstrap shutdown
== See also ==
* 
* 
* MR pull request
Asus Zenfone 5 (asus-t00f)

== Contributors ==
yxist
== Device owners ==
== How to enter flash mode ==
Hold power button and volume up while device is turned off
== Installation ==
Zenfone 5 uses non-standard bootimg format, so we'll need to create it manually.
You'll need a working Zenfone 5 boot.img to proceed.
$ pmbootstrap install --sdcard=/dev/sd?
$ pmbootstrap export
$ git clone https://github.com/shakalaca/ZenFone-boot-tools
$ cd ZenFone-boot-tools
$ make
$ ./pack_intel ./path/to/original/boot.img /tmp/postmarketOS-export/vmlinuz-asus-t00f /tmp/postmarketOS-export/initramfs-asus-t00f output_boot.img
Then you can flash output_boot.img as you normally would using fastboot.
$ sudo fastboot flash boot output_boot.img
== See also ==
* Initial merge request
* 
* 
* Intel MID
Asus Zenfone 5 (asus-t00j)

== Contributors ==
yxist
I have copy pasted the page for the asus-t00f for now, will edit later, they are basically identical devices.
== Device owners ==
== How to enter flash mode ==
Hold power button and volume up while device is turned off
== Installation ==
Zenfone 5 uses non-standard bootimg format, so we'll need to create it manually.
You'll need a working Zenfone 5 boot.img to proceed.
$ pmbootstrap install --sdcard=/dev/sd?
$ pmbootstrap export
$ git clone https://github.com/shakalaca/ZenFone-boot-tools
$ cd ZenFone-boot-tools
$ make
$ ./pack_intel ./path/to/original/boot.img /tmp/postmarketOS-export/vmlinuz-asus-t00f /tmp/postmarketOS-export/initramfs-asus-t00f output_boot.img
Then you can flash output_boot.img as you normally would using fastboot.
$ sudo fastboot flash boot output_boot.img
== See also ==
* Initial merge request
* 
*
Asus Zenfone 6/6Z (asus-i01wd)

== Contributors ==
== Users owning this device ==
== How to power off device ==
Press and hold Volume Down + Power.
== How to enter flash mode ==
Press and hold Volume Up + Power while powered off.
== Installation ==
Use pmbootstrap to build your own installation image.
$ pmbootstrap init
$ pmbootstrap install --fde
== See also ==
Asus Zenfone Max Pro M1 (asus-x00td)

== Contributors ==
* alice-koul
== Maintainer(s) ==
* Aboothahir
== Users owning this device ==
== How to enter flash mode ==
Unlock your phone's bootloader.
Hold and to enter fastboot mode.
== Installation ==
pmbootstrap flasher flash_rootfs
pmbootstrap flasher flash_kernel
Please note, pmbootstrap flasher boot doesn't work
== See also ==
* Qualcomm_Snapdragon_660_(SDM660)
* edk2-msm pull request