Coder Social home page Coder Social logo

nanomod's Introduction

NanoMod

Current Stable Release

5.2.20170413

  • Stable Downloads Androidfilehost Link
  • Archived Downloads Androidfilehost Link

Description

  • install NanoMod or NanoMod-microG Magisk-Module
    • actually NanoMod is an Overlay to /system which holds the apps
    • allows for a user-defined list of system apps to be made unavailable (let's call this pseudo-debloat feature)
    • disabling the NanoMod module in Magisk will revert everything, as it's not actually doing any changes to /system
    • boot process may take a bit longer as NanoMod is a pretty big Magisk Module
    • for more information on Magisk XDA Link
  • install microG Web Link
    • with Mozilla location provider backend F-Droid Link
    • with Nominatim adress provider backend F-Droid Link
    • with microG GsfProxy GitHub Link
    • with microG DroidGuard Helper GitHub Link
    • choose between official Play Store APK Mirror Link or unofficial Yalp Store F-Droid Link
    • microG GmsCore GitHub Link and Play Store modified to allow (in-)app-purchases
  • install F-Droid and many OpenSource applications
    • including the privileged extension, so you don't need to enable 'Unkown Sources' to use F-Droid
    • for more information on F-Droid visit F-Droid Link
  • install GNU Bash Shell GNU Link
  • install GNU Nano Shell Editor GNU Link
  • install The Legend of Zelda rintones and sounds Nintendo Link
    • it's dangerous to root alone

Why was this created?

Because I wanted to have a simple way to achieve my desired setup on any device or any ROM. That's it, basically. And since it already exists, I thought I'd push it to XDA aswell. Actually this is the generic version of my NanoROM for Galaxy S6, where I basically made the same changes to the ROM (except NanoMod is for LOS/AOSP based ROMs, not TouchWiz).

Support

XDA Support Thread XDA Link

Details

License

Each provided application under it's original license. My own work (NanoMod itself) is licensed under the GNU General Public License version 3 or newer GNU Link

Variants

  • Full package contains everything mentioned above
  • microG package only contains microG and nothing else
  • F-Droid package only contains F-Droid and it's Privileged Extension

Installation

  • Download release build Androidfilehost Link
  • or create zip file from this repository
    • on GNU/Linux or BSD you can use the provided mod.sh script, either
      • mod.sh zip for the full package
      • mod.sh microg for the microg only package
      • mod.sh fdroid for the F-Droid only package
  • perform full wipe
    • recommended, but not required
  • install desired ROM
    • make sure it does not include GApps
  • install desired Kernel (if any)
  • install Magisk
  • install NanoMod
    • for microG to work, your ROM needs to have fake signature signing enabled
    • to achieve that, use the supplied framework-patcher.sh. This shell script for GNU Bash (and compatible shells) works on Unixoid operating systems like GNU/Linux, BSD or Mac OSX. It automizes the process of downloading Haystack GitHub Link, pulling files from phone, patching and populating them in the NanoMod Magisk Module.
  • reboot into system
    • go into microG settings and set up everything like:
      • check results in Self-Check, grant missing permissions (by tapping on them)
        • especially the 'Battery Optimization' item
      • enable Google device registration
      • enable Google Cloud Messaging (only if you want to receive push messages from your applications)
      • enable Google SafetyNet (only if you you want to be able to use applications that require SafetyNet, for example AndroidPay, Pokémon GO, ...); set to use the official servers
      • in UnifiedNlp Settings choose
        • Mozilla Location Backend as Geolocation backend
        • Nominatim as Address lockup backend
      • after everything is done, reboot
      • go to Play Store, setup account and install your apps

Alter Installation

To alter the installation you can create the file

/data/media/0/.nanomod-setup

on your phone, which can also be accessed or created as

/sdcard/.nanomod-setup

populate it with the following content for the full package

nanomod.microg=1
nanomod.fdroid=1
nanomod.apps=1
nanomod.play=1
nanomod.reinstall=0
nanomod.overlay=1
nanomod.zelda=1

the microg only package only supports the following options

nanomod.play=1
nanomod.reinstall=0

where 1 means on and 0 means off. Description:

nanomod.fdroid=[0|1]

whether to populate F-Droid.

nanomod.apps=[0|1]

whether to populate FOSS apps (see below).

nanomod.microg=[0|1]

whether to populate microG.

nanomod.play=[0|1|2]

what app store to use. 0 will not populate any app store, 1 will populate Play Store, 2 will populate Yalp Store.

nanomod.overlay=[0|1]

whether to populate the overlay to pseudo-debloat /system applications.

nanomod.zelda=[0|1]

whether to populate Zelda ringtones and sounds.

nanomod.reinstall=[0|1]

whether to backup an already patched services.jar and re-use it.

Only use this, when you re-install NanoMod on the same ROM. If you updated or changed the ROM, re-run framework-patcher.sh instead. See "Installation" below.

If no /data/media/0/.nanomod-setup is found, the default one will be installed (equals to the example above).

Applications

Pseudo-Debloated applications

Default Settings

The following applications are pseudo-debloated by default

  • Basic Dreams
  • CM File Manager
  • Eleven (Audio Player)
  • E-Mail + Exchange2
  • Browser, Gello, Slimperience (Browser)
  • PhotoTable
  • Sound Recorder, Recorder
  • messaging (SMS & MMS)
  • Wallpaper, WallpaperPickerGoogle (Google Wallpaper application)
  • Wallpaper Backup
  • mGerrit
  • FM Radio
  • Gallery2
  • OmniSwitch
  • Screencast
  • Snap, Snapdragon Camera (Camera)
  • Resurrection Remix Statistics
  • Sim Toolkit
  • Pixel Launcher
  • Trebuchet

Alter the list of pseudo-debloated applications

You can add or remove applications from the list by modifying the file

/data/media/0/.nanomod-overlay

on your device, which is also accesible as

/sdcard/.nanomod-overlay

See the default settings GitHub Link. The syntax is pretty simple:

  • one item per line
  • name must be an exact match
  • applications in /system/app inside APPS=( ... )
  • applications in /system/priv-app inside PRIV_APPS=( ... )

After you've made your changes, issue the following command on your phone, either using adb shell or Termux as root:

nanomod-overlay --update

This needs to be done in normal environment. If you're in TWRP you'll have to manually mount /magisk. For this you can use the supplied mount-magisk.sh script, connect phone to PC while in TWRP and run the following commands

adb push mount-magisk.sh /tmp/
adb shell
chmod 0755 /tmp/mount-magisk.sh
/tmp/mount-magisk.sh

afterwards you can call nanomod-overlay like

/magisk/NanoMod/system/bin/nanomod-overlay --update

from TWRP, aswell. Issue

/tmp/mount-magisk.sh

again to unmount /magisk. Reboot for your changes to get applied. For more options, check:

nanomod-overlay --help

respectively

/magisk/NanoMod/system/bin/nanomod-overlay --help

from TWRP.

Applications provided by NanoMod

The following applications are magic-mounted as /system applications

  • AdAway F-Droid Link
  • Amaze (File Manager) F-Droid Link
  • AnySoftKeyboard F-Droid Link
  • Face Slim (Facebook client) F-Droid Link
  • F-Droid (FOSS app store) F-Droid Link
    • F-Droid Privileged Extension F-Droid Link
  • Hacker's Keyboard F-Droid Link
  • K-9 Mail F-Droid Link
  • Kernel Adiutor GitHub Link
  • KeyPassDroid (Password Safe) F-Droid Link
  • (Simple) Gallery F-Droid Link
  • Lightning (Browser) F-Droid Link
  • Magisk Manager GitHub Link
  • New Pipe (YouTube client) F-Droid Link
  • Oandbackup (App backup and restore) F-Droid Link
  • Odyssey (Audio player) F-Droid Link
  • OpenCamera F-Droid Link
  • OpenKeyChain F-Droid Link
  • OpenLauncher F-Droid Link
  • OpenVPN F-Droid Link
  • QKSMS F-Droid Link
  • Substratum (App and Compiler) GitHub Link
    • will run in legacy mode on non-OMS ROMs
  • Termux F-Droid Link
  • Twidere (Twitter client) F-Droid Link
  • VLC (Audio/Video Player) GitLab Link
  • XDA Labs XDA Link
    • source not (yet) available
  • Yahoo Weather Provider GitHub Link

Issues

List of known issues

  • microG DroidGuard Helper or Play Store crashing
    • there's currently an issue with Magisk that prevents microG DroidGuard Helper or Play Store from properly working when magic-mounted as /system application, see Magisk Issue 155 GitHub Link
    • this does not happen on all devices
    • if you are affected of this issue, instead install them as an user app, by installing the apk from
      • /system/priv-app/DroidGuardHelper/DroidGuardHelper.apk for microG DroidGuard Helper
      • /system/priv-app/Phonesky/Phonesky.apk for Play Store
  • Play Store lacks fake sign permission
    • on ROMs like crDroid or OmniROM, that have built-in fake signing and don't require running framework-patcher.sh, in some cases the Play Store is not granted fake sign permission, to fix this issue one of the following commands as root on your phone
      • nanomod-overlay --permission
      • pm grant com.android.vending android.permission.FAKE_PACKAGE_SIGNATURE

Magisk & root

Magisk allows modifying the ROM in system less fashion, it also brings it's own root solution (MagiskSU, which apparently is a fork of PHH SuperUser) and an companion application.

SafetyNet

To pass SafetyNet enable MagiskHide in Magisk Manager and reboot.

Hiding Root from Apps

After enabling MagiskHide and reboot go to Magisk Manager again, you'll now notice a new MagiskHide settings tab. In this tab you can select any application root should be hidden for. No reboot is required for this to take effect.

Note: don't select too many apps (10+), else MagiskHide may be too slow to actually hide root before the application checks for it.

Zelda ringtones & sounds

The following The Legend of Zelda sounds will be populated

Notification sounds

  • Flute
  • Gold Bug Catch
  • Hey Listen
  • Intro
  • Midna Alert
  • Secret
  • Start
  • Vessel

Ringtones

  • Bolero of Fire
  • Gerudo Valley
  • House Remix (original title theme)
  • Lost Woods Dubstep
  • Lost Woods
  • Market Theme
  • Minuet of Forest
  • Nocturne of Shadows
  • Prelude of Light
  • Requiem of Spirits
  • Sarias Song
  • Serenade of Water
  • Shadow World
  • Song of Storms
  • Song of Time

User Interface Sounds

  • Lock
  • LowBattery
  • Unlock

FAQ

Q: will there be a GApps version, instead of microG?
A: no. but you can choose not to populate microG.

Q: will there be support for x86?
A: x86 support is not planned currently.

Q: what devices was this tested on?
A: Moto X Play (lux), Samsung Galaxy Tab 4 (matissewifi), Samsung Galaxy S6 (zeroflte)

Q: what ROMs was this tested on?
A: LineageOS, Resurrection Remix, AICP, AOSP Extended, crDroid, should work on any LineageOS / AOSP based ROM that is working with Magisk.

nanomod's People

Contributors

nanolx avatar victor141516 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.