• GPS coordinates
• Altitude bar
• Altitude counter
• Photo EXIF info extractor
• Custom text for filter Lens in LayoutConfig.py
• Distance from operator
• Total distance
• Horizontal speedometer with text in m/s and km/h
• Vertical speedometer with text in m/s and km/h
• Satellite counter with colored text based on satellite count
• Flight path maps auto scale based on the area covered

git clone https://github.com/JrVolt/DJI2Lz.git

cd DJI2Lz

pip install -r requirements.txt

# Configure a valid font in `LayoutConfig.py` before running

python3 DJI2Lz_Launcher.py

For long shoot/flight, divided in multiple DJI.mp4 please follow this process, for correct GPS drawing.

1. Extract all the .srt from the videos DJI_0001.mp4 DJI_0002.mp4 DJI_0003.mp4
2. Merge the extracted file, Launcher option 5
3. Generate the HUD from DJI_MERGED_0001-0002-0003.srt

The script will export lots of trasparent .png in UHD resolution (3840x2160) In you preferred video editor make sure to strech each to cover 1 sec of video, based on your timeline's frame rate.

(IE: Video@25p each .png shuld last 25 frames.)

This project uses an executable from another open-source project named dji-log-parser by lvauvillier . The binary is provided along with the files for user convenience. All credit for that to him. However, you must obtain and add a valid DJI API key to decode the flight log.

API Setup:

1. Rename SAMPLE_DJI_API_KEY.py in DJI_API_KEY.py
2. Edit the file with a valid key

• Linux/Unix: Fully supported.
• Mac: Should work at 99% with minor fixes. (brew maybe ?)
• Windows WSL: May work, but troubleshooting will likely be required.
• Windows (Native): Not supported. Feel free to fork and add support for Windows.

It suppsed to be compatible to every DJI drone that support the telemetry in subtile track with correct/supported telemtry syntax.

Supported

F, SS, ISO, EV, DZOOM, GPS (N, E, H), D m, H m, H.S m/s, V.S m/s

Forcable Unsupported

[iso : ] [shutter : ] [fnum : ] [ev : ] [ct : ] [color_md : d] [focal_len : ] [latitude: ] [longitude: ] [rel_alt: abs_alt: ]

(Mainly for the lack of speed data)

I can confirm that :

• WORKING with latest firmware of DJI Mini, DJI Mini 2 (up tp 04/25)
• NOT WORKING with Mavic Air 2 (FW 01.01.0610) (can be forced)

For complete support table refer to DroneSupport.md

Some older drone or firmware (maybe both) have a separate .srt along the .mp4 file.

Force unsupported

Overall compatibility won't change HOWEVER

It's availlable module to convert the unsupported telemetry for HUD generation. Launcher option 8 Spoofed value are added and set to 0 if missing, edit the module if you want.

NOTE : In this case you will find A LOT MORE .png, this time ONE.png=1ftg No need to strech each png to 1 sec.

It's suggested to turn off :

• Speedometer
• GPS Count
• RC Distance

Change UNSUPPORTED = True/False or do it manually

All visual elements can be customized through constants in LayoutConfig.py. These include:

• Resolution If edited instruments repositioning is required. (Preset UHD downscale if needed)
• Text Color
• Font Details

Each instrument can be individually enabled or disabled with ease with a simple list of True/False option.

• Altitude Limits: Easily configure minimum and maximum altitude values.
• Speed Limits: Customizable, but altering these values might break the speedometer drawing. Proceed with caution.

All text positioning is configured in the DJI2Lz-HUD_Generator.py module. Pay close attention when making changes. (Is way easier do it in your preferred video editor software)

• Pillow (PIL)
• matplotlib
• numpy

Each modules can be executed standalone, execpt for the flightrecord decode that require dji-log, PLEASE DO NOT; they are safer to use with the launcher.

All the goal of the project has already been achieved, it can be considered complete.

Eventually all minor update. (I Lied... 05/25)

1. Fork the repository.
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Open a Pull Request.

This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.