Unofficial FindMyDevice(FMD) Server Python Client

This is an unofficial Python package that allows you to interact with the FindMyDevice Server API. FindMyDevice Server is a server designed to communicate with the FMD Android app, helping you locate and control your devices.

The main use of this package is currently a reimplementation of the crypto and authentication involved when communicating with the api.

✨ Features and working commands

• Authenticate to the FindMyDeviceServer API.
• Send a "ring" to the server

📦 Installation

pip install findmydevice

🚀 Quick start

from findmydevice import FMDClient
import logging 

logging.basicConfig(level=logging.DEBUG)
client = FMDClient('http://xyz.de', 'fmd_id', 'fmd_password')
client.authenticate()
client.ring()

🚀 Development

1️⃣ Setup a Local Development Environment

1. Clone the repository

   git clone https://github.com/kinkerl/findmydevice_python.git
   cd findmydevice_python

2. Create a virtual environment

   python -m venv .venv

3. Activate the virtual environment
   • macOS/Linux:

     source .venv/bin/activate

   • Windows (CMD):

     .venv\Scripts\activate

   • Windows (PowerShell):

     .venv\Scripts\Activate.ps1

4. Install dependencies

   pip install -e .[dev]

2️⃣ Running Tests

To run tests using pytest, use:

pytest

3️⃣ Building the Package

1. Ensure you have Twine installed

   pip install build

2. Build the package

   To build the package, run:

   python -m build

   This will generate a dist/ directory with .tar.gz and .whl files.

4️⃣ Uploading to PyPI

1. Ensure you have Twine installed

   pip install twine

2. Upload the package

   twine upload dist/*

3. Verify installation from PyPI

   pip install findmydevice