Skip to content

Latest commit

 

History

History
171 lines (150 loc) · 9.06 KB

README.md

File metadata and controls

171 lines (150 loc) · 9.06 KB

ViPER4AndroidRepackaged

A refined ViPER4Android installer.

This is an updated and enhanced ViPER4Android FX 2.7 installer.
It contains many useability enhancements and all the major fixes needed to run ViPER4Android on modern ROMs effortlessly.

GitHub Latest Release (by date) GitHub Latest Release Date
GitHub Global Download Counter GitHub Latest Download Counter
GitHub Workflow Status GitHub Workflow ShellCheck Status GitHub commits since last release GitHub last commit
GitHub Repo stars
GitHub followers

Features

  • Install ViPER4Android in one go
    No need for additional modules or multiple reboots.
  • Quick install
    The entire install procedure has been rewritten from the ground up to be quick, simple and robust.
  • ViPER4Android APK included
    There is no longer a need for an active internet connection during install, as the ViPER4Android APK is included in the install zip.
  • Automatic seamless ViPER driver install
    This installer installs the ViPER driver seamlessly during module installation, there is no need to have the app install the driver.
  • MagiskPolicy included
    The necessary SELinux rules for running on modern Android ROMs are included, there is no need for Audio Compatibility Patch anymore.
  • Enforce the law
    This installer does not require switching SELinux to permissive temporarily for installing the APK, which mostly helps with devices where permissive has been disabled in the kernel.
  • Old folder gone legacy
    The old folder ViPER4Android in your personal files has been redundant for long time already, as all files have been moved to the new scoped storage location anyways.
    This installer doesn't depend on the old folder anymore, you can safely delete it and not have it clutter your files anymore.
  • ViperFX, not AudioFX!
    Who needs LineageOS AudioFX anyways when you have ViPER4Android installed. This installer automatically disables LineageOS AudioFX during install and also reenables it during uninstall.
  • Viper Atmos
    Experience breakthrough audio that flows above and around you with ViPER4Android.
    Dolby Atmos has become a simple marketing term anyways, you don't need it anymore, you got somethin' better now!
  • To AML or not to AML
    Audio Modification Library is not included, but is usually not needed either. You can still combine ViPER4Android with other audio mods using Audio Modification Library if you want to.
  • Automatic VDC, IRS and preset import
    If you have bought a VDC file or downloaded an IRS file or preset, you don't have to copy it over manually. The installer automatically finds and copies them to the correct place for ViPER4Android to find them and for you to enjoy the audiophile feeling.
  • Original DDCs included
    If you have not yet bought a VDC file, this installer will automatically install all original ViPER4Android DDC files for you to enjoy them until you notice you can buy even better ones.
  • IRS (tax) included
    The whole pack of IRS files commonly distributed in the ViPER4Android Telegram group is included and will be automatically copied to the correct place. You can select an IRS in the convolver option.
  • Legacy mode for the win
    To this day I don't see why one would want to have Legacy mode disabled. Yes I know it's because a media app should send it's audio session id, but to be honest: Who cares? Legacy mode just always works reliably and this is why this installer enables it by default. Does anyone remember the time when this option was called "Process audio session 0"?
  • Opt-in instead of Opt-out
    ViPER4Android 2.7 comes with Crashlytics bug report metrics enabled by default. Personally I don't like to send bug reports, so I always disable it. I think Opt-in is the way to go here. This is why in this module Crashlytics is disabled by default and you may enable if it you wish to.
  • Keep the vibes alive
    Measures have been put in place to ensure ViPER4Android doesn't get killed by the OOM-killer. Though should ViPER4Android stop working anyways, it will automatically be restarted. This may be of great convenience on low ram devices where the OOM-killer is very aggressive, even towards foreground services.
  • I know you're doing fine
    The notifications of ViPER4Android have been permanently disabled. There is no need for this permanent cluttering of the notifications list. (more)

Install

  1. Download the latest module ZIP from GitHub Releases
  2. Flash in Magisk/Lygisk
  3. Reboot

The installer installs the ViPER4Android app for you. Don't install it yourself.

This mod is targeted at LineageOS 21.
It has been tested to work on:

  • LineageOS 16.0 on s3ve3gjv
  • LineageOS 17.1 on a5xelte
  • LineageOS 18.1 on sailfish
  • LineageOS 19.1 on dreamlte
  • LineageOS 20.0 on beyond1lte, beyond2lte, gts4lv
  • LineageOS 21.0 on beyond2lte

Please don't submit pull requests adding your device/ROM combination.
I will only add devices which I can test myself.

Upgrade

Just install the update normally by clicking the update button within your Magisk app or do it manually following the install instructions

A reboot is recommended afterwards, but usually not required. You can just postpone it and combine it with the next reboot that you'd do anyways.

Reimport VDC/IRS files

For reimporting newly downloaded VDC or IRS files from your downloads directory, just follow the upgrade instructions.

You don't need to restart afterwards, the new files will be available immediately.

Bugs and support

I am not a ViPER dev, nor am I capable of fixing your broken install or ROM.
If you have trouble to install ViPER4Android this way, please do hesitate to ask me.
Try to install it the normal way and if that doesn't work either, ask in the ViPER4Android Telegram group or the ViPER4Android XDA Thread instead.

Where is the notification?

The notification has been disabled on purpose, as I don't see the necessity of it.
I know the App-Info toggle to enable notifications does not work.
If you really need it, run this command: pm set-distracting-restriction com.pittvandewitt.viperfx

Thanks

If you want to invest into a great dev, go and donate to @pittvandewitt.

Thank you @pittvandewitt for keeping my absolute favorite mod alive for so long! If you read this @pittvandewitt, please message me on Telegram, so that we can make the next ViPER4Android version even more epic than it already is!