Giter Club home page Giter Club logo

altserver-linux's Introduction

AltServer-Linux

AltServer for AltStore, but on-device

Usage

  • Install IPA: ./AltServer -u [UDID] -a [AppleID account] -p [AppleID password] [ipaPath.ipa]
  • Running as AltServer Daemon: ./AltServer
  • Full usage (maybe outdated, refer to ./AltServer -h for the newest):
Usage:  AltServer-Linux options [ ipa-file ]
  -h  --help             Display this usage information.
  -u  --udid UDID        Device's UDID, only needed when installing IPA.
  -a  --appleID AppleID  Apple ID to sign the ipa, only needed when installing IPA.
  -p  --password passwd  Password of Apple ID, only needed when installing IPA.
  -d  --debug            Print debug output, can be used several times to increase debug level.

The following environment var can be set for some special situation:
  - ALTSERVER_ANISETTE_SERVER: Set to custom anisette server URL
          if not set, the default one: https://armconverter.com/anisette/irGb3Quww8zrhgqnzmrx, is used
  - ALTSERVER_NO_SUBSCRIBE: (*unused*) Please enable this for usbmuxd server that do not correctly usbmuxd_listen interfaces

Download

  • Precompiled static binary can be downloaded in Release ( also have a look at pre-release ;) )
  • Nightly version is available as Github Actions artifacts

TODO / Special Features

  • Track upstream (AltServer-Windows) develop branch (i.e. Beta version)
  • Support Offline Anisette Data Generation (i.e. without Sideloadly)
    • Finsihed, please run alt_anisette_server & use ALTSERVER_ANISETTE_SERVER to specify custom server URL
  • Support Wi-Fi Refresh
    • netmuxd now supports network devices (needs version > v0.1.1, be sure to check pre-release)
      • Download netmuxd, stop the original usbmuxd, and run netmuxd before running AltServer-Linux
      • If netmuxd does not work, please try using special env var ALTSERVER_NO_SUBSCRIBE. Enabling this would disable auto-refresh when plugged-in of USB devices

Advanced: Build Instruction (check Github Actions if you cannot build)

  • Preparation: git clone --recursive https://github.com/NyaMisty/AltServer-Linux

  • Install dependencies (see notes below): corecrypto_static, cpprestsdk static lib, boost static lib

  • Build:

    cd AltServer-Linux
    mkdir build
    make -f ../Makefile -j3
    ls AltServer-*
    
  • My own build note for you

      1. Run alpine docker (change --platform to corresponding architecture you want): 
          docker run --platform=linux/arm/v7 --name altserver-builder-alpine-armv7 -it alpine:3.15 
      2. Install dependencies:
          apk add zsh git curl wget g++ clang boost-static ninja boost-dev cmake make sudo bash vim libressl-dev util-linux-dev zlib-dev zlib-static
      3. Install corecrypto
          download corecrypto from apple website, unzip corecrypto.zip; cd corecrypto; mkdir build; cd build; CC=clang CXX=clang++ cmake ..;
          vim CMakeFiles/Makefile2, delete line starts with "all: corecrypto_perf/....." and "all: corecrypto_test/.....", then make; make install
      4. Install cpprestsdk
          git clone --recursive https://github.com/microsoft/cpprestsdk; cd cpprestsdk; mkdir build; cmake -DBUILD_SHARED_LIBS=0 ..; make; make install
          (if you're compiling for armv7, you have to grep -Wcast-align, and remove it, or the compiling would fail)
      5. Install libzip
          git clone https://github.com/nih-at/libzip; cd libzip; mkdir build; cd build; cmake -DBUILD_SHARED_LIBS=0 ..; make; make install
      6. Compile AltServer-Linux
          git clone --recursive https://github.com/NyaMisty/AltServer-Linux
          cd AltServer-Linux
          make -f ../Makefile -j3
          (if you're compiling for ARM, i.e. armv7 or aarch64, you'll have to remove the -mno-default flag in Makefile)
    
    

altserver-linux's People

Contributors

nyamisty avatar github-actions[bot] 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.