Introduction

iodéOS is a privacy-focused operating system powered by LineageOS and based on the Android mobile platform. iodéOS aims at protecting the user's privacy with a built-in adblocker and by freeing the smartphone from snitches.

The objectives in the conception of this ROM are threefold:

1. To keep the stability and security level of LineageOS, by minimizing the modifications made to the system. Apart the system modifications required by the adblocker, we mainly only added a few useful options commonly found in other custom ROMs, made some cosmetic changes, modified a few default settings to prevent data leaks to Google servers.
2. To ease a quick adoption of this ROM by new users. We especially target users that are concerned by the protection of their privacy, but are not reluctant to still use inquisitive apps like Google ones. We thus included MicroG as well as a coherent set of default apps, and simplified the initial setup of the system. Particularly, an initialization of MicroG has been made with GCM notifications allowed by default, a privacy-friendly network location provider (DéjàVu) pre-selected, as well as Nominatim Geocoder.
3. To provide a new and powerful way of blocking ads, malwares, data leaks of all kinds to many intrusive servers. We are developing an analyzer, tightly integrated into the system, that captures all DNS requests and network traffic, as well as a user interface (the iodé app). Compared to some other well-known adblockers, this has the advantages of:
   • Avoiding to lock the VPN for that use. You can even use another adblocker that uses VPN technology alongside our blocker.
   • Being independent of the kind of DNS server used by the system or set by an independent app: classical DNS on UDP port 53 or any other one, DNS over TLS (DoT), DNS over HTTPS (DoH), ..., as we capture the DNS requests before they are transmitted to the system function that emits the DNS request. What we do not support, is DoH when it is natively built into applications, i.e. when an app communicates directly with a DoH server, without asking name resolution to the system. It would require to decrypt HTTPS packets between such an app and the DoH server, which may create a big security hole.
   • Precisely mapping DNS requests and network packets to the Android apps that emitted (or received) them.
   • Deciding which apps have a filtered network usage (by default, all apps), and which ones can communicate with blacklisted servers.

Since its first versions, we added many features to the iodé blocker: several levels of protection, fine-grained control over the hosts that should be blocked or authorized, displaying statistics on a map to see the quantity of data exchanged to which countries, clearing statistics... We are actively developing the blocker, and new functionalities will be regularly added.

What's included

Changes in LineageOS to prevent data leaks:

• Default DNS server: Google's DNS replaced by Quad9's 'unblocked' servers in all parts of the system.
• A-GPS: patches to avoid leaking personnal information like IMSI to supl server.
• Captive portal login: connectivitycheck.gstatic.com replaced by captiveportal.kuketz.de for connectivity check.
• Dialer: Google default option replaced by OpenStreetMap for phone number lookup.

Pre-installed apps:

We included many useful default apps, but our choice cannot suit everyone; so we added the possibility to remove them. It can be done at the end of the phone setup, or at any time by going to Parameters -> Apps & Notifications -> Preinstalled apps.

• MicroG core apps: GmsCore, GsfProxy, FakeStore.
• NLP backends for MicroG : DejaVuNLPBackend (default), MozillaNLPBackend, AppleNLPBackend, RadioCellsNLPBackend, NominatimNLPBackend
• App stores : FDroid (with F-Droid Privileged Extension) and Aurora Store.
• Browser: our own fork of Firefox (with Qwant as default search engine, many other ones added, telemetry disabled, parts of telemetry code removed) instead of * * Lineage’s default browser Jelly.
• SMS: QKSMS instead of Lineage's default SMS app.
• Email: p≡p (Pretty Easy Privacy).
• Camera: our own fork of Open Camera, with a few tweaks.
• Maps/navigation: Magic Earth GPS & Navigation (the only one free but not open source).
• Keyboard: OpenBoard instead of AOSP keyboard.
• PDF: Pdf Viewer Plus.
• Personnal notes: Carnet.
• {Ad/Malware/Data leak}-blocker: iodé.
• News: to keep users informed about our developments, as well as a FAQ.
• Meteo: Geometric Weather.

Useful options from other custom ROMs:

• Smart charging (disables charging when a given level is reached, to protect battery health).
• Fingerprint vibration toggle.

How to flash Fairphone (FP3, FP3+, FP4)

FP3, FP3+

1. Update the stock firmware to the latest
2. Unlock your phone by following the instructions from Fairphone website
3. adb reboot bootloader (or press VOLUME DOWN and plug phone while it's shut down)
4. fastboot oem unlock
5. fastboot flash boot <recovery for FP3(+)>
6. press POWER+VOLUME UP until reboot in recovery
7. From recovery => Factory reset => Format Data/factory reset
8. From recovery => Apply update => Apply from ADB => adb sideload <iodéOS for FP3(+)>
9. fastboot oem lock

FP4

1. Update the stock firmware to the latest
2. Unlock your phone by following the instructions from Fairphone website
3. adb reboot bootloader (or press VOLUME DOWN and plug phone while it's shut down)
4. fastboot flashing unlock
5. fastboot flash recovery_a <recovery for FP4>
   fastboot flash recovery_b <recovery for FP4>
6. In order to relock bootloader: fastboot flash avb_custom_key <avb_custom_key-FP4.bin>
7. press POWER+VOLUME UP until reboot in recovery
8. From recovery => Factory reset => Format Data/factory reset
9. From recovery => Apply update => Apply from ADB => adb sideload <iodéOS for FP4>
10. fastboot flashing lock
11. Boot, and in developer settings uncheck "OEM unlocking"

How to flash Teracube

2E 2022 batch (emerald)

1. Update the stock firmware to the latest
2. Unlock OEM in developer settings
3. Reboot to bootloader
4. fastboot flashing unlock
5. fastboot flash boot <recovery for 2E>
6. Reboot to recovery
7. From recovery => Factory reset => Format Data/factory reset
8. From recovery => Apply update => Apply from ADB => adb sideload <iodéOS for 2E>

2E 2021 batch

1. Update the stock firmware to the latest
2. Unlock OEM in developer settings
3. Reboot to bootloader
4. fastboot flashing unlock
5. fastboot flash recovery <recovery for 2E>
6. Reboot to recovery
7. From recovery => Factory reset => Format Data/factory reset
8. From recovery => Apply update => Apply from ADB => adb sideload <iodéOS for 2E>

How to flash Xiaomi (Mi9, Mi 10 LITE, Mi 10T (Pro), Redmi K30S Ultra)

1. Update the stock firmware to the latest
2. Unlock your phone by following the instructions from Xiaomi website
3. adb reboot bootloader (or press power+VOLUME DOWN)
4. fastboot flash recovery iodé mi9 recovery image | iodé Mi 10 LITE recovery image | iodé Mi10T (pro) recovery image
5. Press POWER+VOLUME UP until reboot in recovery
6. From recovery => Factory reset => Format Data/factory reset
7. From recovery => Apply update => Apply from ADB => adb sideload <rom.zip> (iodéOS for Mi 9 | iodéOS for Mi 10 lite | iodéOS for Mi 10T (pro) zip ROM )

How to flash Samsung

A5 (2017), A7 (2017)

1. Update the stock firmware to the latest
2. Unlock OEM in developer settings
3. Reboot and press power/vol-/home buttons altogether.
4. Flash recovery for A5 | recovery for A7 with command: heimdall flash --RECOVERY <recovery_filename>.img
5. As soon as the flash ends, quickly press power/vol+/home buttons altogether to directly reboot to recovery
6. From recovery => Factory reset => Format Data/factory reset
7. From recovery => Advanced => ADB Sideload: swipe to start sideload, and issue adb sideload <rom.zip> (iodéOS for A5 | iodéOS for A7)

S9, S9+, Note9

1. Update the stock firmware to the latest
2. Unlock OEM in developer settings
3. At reboot, follow the setup wizard, make sure to be connected to the internet, then activate developer options
4. Activate adb and type: 'adb reboot bootloader', or press power/vol-/bixby buttons altogether.
5. Flash lineageOS recovery for S9 or recovery for S9+ or recovery for Note9 with command: heimdall flash --RECOVERY <recovery_filename>.img
6. As soon as the flash ends, quickly press power/vol+/bixby buttons altogether to directly reboot to recovery
7. From recovery => Factory reset => Format Data/factory reset
8. From recovery => Apply update => Apply from ADB => adb sideload <rom.zip> (iodéOS for S9 | iodéOS for S9+ | iodéOS for Note9)

S10, S10e, S10+

1. Update the stock firmware to the latest
2. Unlock OEM in developer settings
3. Activate adb and type: 'adb reboot bootloader', or shut down phone &  press vol-/bixby buttons altogether while plugging to computer
4. In Download Mode (DL), long press Vol+ and unlock bootloader
5. Reboot to DL mode & flash recovery for S10 | recovery for S10e | recovery for S10+ with command: heimdall flash --RECOVERY <recovery_filename>.img
6. As soon as the flash ends, quickly press power/vol+/bixby buttons altogether to directly reboot to recovery
7. From recovery => Factory reset => Format Data/factory reset
8. From recovery => Apply update => Apply from ADB => adb sideload <rom.zip> (iodéOS for S10 | iodéOS for S10e | iodéOS for S10+)

Note 10, Note 10+

1. Update the stock firmware to the latest
2. Unlock OEM in developer settings
3. Activate adb and type: 'adb reboot bootloader', or shut down phone &  press vol+/vol- buttons altogether while plugging to computer
4. In Download Mode (DL), long press Vol+ and unlock bootloader
5. Reboot to DL mode & flash recovery for Note 10 | recovery for Note 10+ with command: heimdall flash --RECOVERY <recovery_filename>.img
6. As soon as the flash ends, quickly press power/vol+/bixby buttons altogether to directly reboot to recovery
7. From recovery => Factory reset => Format Data/factory reset
8. From recovery => Apply update => Apply from ADB => adb sideload <rom.zip> (iodéOS for Note 10 | iodéOS for Note 10+)

How to flash Sony Xperia (XA2, XZ1, XZ2, XZ3)

1. Get your unlock code from Sony website
2. Unlock bootloader: connect to a wifi in order to grey-out "Unlock OEM" in developer settings
3. adb reboot bootloader (or press VOLUME UP and plug phone while it's shut down)
4. fastboot oem unlock 0x<unlock code>
5. Following your device:
   • XA2:
     fastboot flash boot_a boot-pioneer.img
     fastboot flash boot_b boot-pioneer.img
   • XZ1:
     fastboot flash recovery recovery-poplar.img
   • XZ2:
     fastboot flash boot_a boot-akari.img
     fastboot flash boot_b boot-akari.img
   • XZ3:
     fastboot flash boot_a boot-akatsuki.img
     fastboot flash boot_b boot-akatsuki.img

XA2, XZ1, XZ2

1. Unplug the phone
2. press POWER+VOLUME DOWN until reboot in recovery
3. From recovery => Factory reset => Format Data/factory reset
4. From recovery => Apply update => Apply from ADB => adb sideload <rom.zip> (iodéOS for XA2 | iodéOS for XZ1 | iodéOS for XZ2)

XZ3

1. Unplug the phone
2. press POWER+VOLUME DOWN until reboot in recovery
3. From recovery => Factory reset  => Format Data
4. From recovery => Apply update => Apply from ADB => adb sideload <iodéOS for XZ3>