Skip to content

Latest commit

 

History

History
72 lines (50 loc) · 2.69 KB

README.md

File metadata and controls

72 lines (50 loc) · 2.69 KB

@airplanegobrr/fmd-js-api

This is an API for the FMD Server (Version 0.12.0)

Android app: FMD App

This uses the Modern encrytion, the API is based off the scripts found in FMD Server Web and looking at the network logs

This uses axios, argon2, and @peculiar/webcrypto

This also has JsDocs so IntelliSense works!

If you like this project please make sure to ⭐ (star) it, it would mean alot to me :D

PR's and Issues are welcome!

How to use

const FMD_API = require("@airplanegobrr/fmd-js-api")

let fmdAPI = new FMD_API("<deviceID>", "<password>", {
    url: "https://fmd.nulide.de/" // Defaults to https://fmd.nulide.de/ if none is supplied
})

// You don't need to explicitly login- but its good practice
fmdAPI.login().then(async (data)=>{
    // Data has an object with accessToken and privateKey, You really dont need to use these but it's nice to have incase

    await fmdAPI.commands.locate() // Tells the device to send its current location to the server, might take awhile for the device to send its loction back to the server.

    let location = fmdAPI.locate(-1) // Gets the lastest location, keep in mind this will NOT ask for the device for its current location, it asks the server what the last location the device sent to the server!
    console.log(location)

    // fmdAPI.commands also has some commands like:
    // locate
    // locate_gps
    // locate_cell
    // locate_last
    // ring
    // lock
    // camera_front
    // camera_back

    let picCount = await fmdAPI.getPictureCount() // Get ammount of pictures the server has
    let picBuffer = await fmdAPI.getPicture(picCount) // Takes the picture index (biggest number == lastest)
    console.log(picCount, picBuffer)
})

FAQ

  • Q: How do I get a list of devices the server has?
  • A: You can't, that would be a big security risk, it would be nice if it were available for private server but its not
  • Q: How do I delete my device?
  • A: This is a big risk, I didn't add it as again its a risk- if you want to do it do fmdAPI.sendToPhone("delete <pin>"), this will NOT be added to the commands object- too risky

Updates

v2.1.1

  • Fixed up code
  • Supports up to FMD server v0.12.1 (Tested- works like normal)
  • Updated default FMD server
  • Auto login and relogin (this was annoying to handle on the user end)

v2.1.0

  • Added alpha tags for support of FMD server v0.12.0

v2.0.0

  • Updated to support FMD server version 0.11.0, needed to add CmdSig to the /commands post endpoint
  • Not %100 tested but it should do fine-