🖼️ Rust Image Frame Tool

Project details

Project: RustImageFrameTool
dev language: Python (Tkinter)
Version: 1.0.0
Author: @RustFlash

The Rust Image Frame Tool is a desktop tool that allows you to quickly and cleanly fit images into predefined Rust frames.
Drag-and-drop, zoom, auto-fit, export, and direct upload are integrated.

• Features
• Requirements
• Installation
• Getting Started
• Operation
• Export & Upload
• Troubleshooting
• Support

• 🖼️ Over 20 Rust Frames (Signs, Picture Frames, Banners, Neon signs)
• 🔍 Live search for all frame types
• 🖱️ Drag, position, zoom directly in the preview
• ✨ Auto-fit function -- image fills the frame perfectly
• 🔄 Reset function -- reset everything immediately
• 💾 Image export as PNG in original frame size
• 🌐 Direct upload to the RustFlash image server
• 🎨 Rust-inspired dark theme
• ⚡ Extremely easy to use

• Python 3.10+

• These Python packages:

  pillow
  requests
  

python ImageFrameTool.py

After starting, the main window opens directly with:

• Frame list on the left
• Image preview on the right
• Controls at the bottom

No additional arguments are necessary.

On the left, you will find all available frames:

• Icon
• Name
• Original size (e.g., 256×128 px)

Simply click on it -- the selected frame will be confirmed at the top.

Click on 📁 UPLOAD IMAGE.

Supported formats:\

• PNG
• JPG / JPEG
• BMP
• GIF

The image will be automatically loaded into the preview.

In the preview, you can:

• Left-click + drag → Move image\
• Mouse wheel → Zoom
• ➖ / ➕ buttons → Fine zoom
• AUTO FIT → Fills the frame completely
• RESET → Sets everything to 0/0/100%

The preview always shows a scaled live view of the final export.

With 💾 SAVE, the tool generates a PNG file in:

• full frame resolution
• with your set offsets & zoom
• transparent background, if not completely filled

File name is suggested automatically.

With 🌐 GENERATE LINK:

1. Image is rendered locally
2. Tool uploads it to the RustFlash server via API
3. You receive the link directly in a pop-up window
4. Link can be copied using a button

Errors (timeout, bad JSON, wrong key) are clearly displayed.

Problem Cause Solution

**Frame is not displayed No frame selected Select frame on the left **

Export button Image missing Upload image first disabled

Upload fails API key incorrect / server Check API key, unreachable Check internet connection

Zoom behaves strangely Frame smaller than image Use AUTO FIT

Image is shifted Offsets set Use RESET

Image smaller than frame:
→ Increase zoom or use AUTO FIT.

Unreadable server response:
→ Server does not return JSON; debug is already built in (console output).

For questions, bugs, or improvements:
Discord server → **https://discord.gg/2ftdtaTQ6S**\ Select role FLASH.

MIT License -- Use only.

load, edit, frame, upload -- done ❤️