This repository was archived by the owner on Nov 30, 2025. It is now read-only.
Releases: Harfull/Placy
Releases · Harfull/Placy
Version 1.4.2
1.4.1
Full Changelog: v1.4...v1.4.1
Version 1.4
I don't even remember what I added
Version 1.3
This is a full rewrite of Placy, it improves performance, stability and adds more file types.
Fixes a bug with zip compressing.
Version 1.2.1
Adds new logging for Async Processing and Secret Key
Version 1.2
Fixes some issues and replaces the default logger.
Version 1.1
🚀 New in this Release
Async Processing
- Enable parallel file handling by setting the environment variable:
ASYNC_PROCESSING=true - Once enabled, batch transformations are available at:
/api/v1/transform/batch
Auto Updater
- Add
PlacyUpdater.jarto your setup. - Update your start script to launch
PlacyUpdater.jarinstead ofPlacy.jar. - The updater will automatically keep your installation up to date.
Version 1.0
What is Placy?
A simple file transformation service that replaces placeholders in files and archives. Built with Spring Boot and Java 17.
What's New in v1.0
- Initial stable release
- REST API for transformation
- Support for most file types: ZIP, JAR, text files, images, documents
- Advanced placeholder replacement functionality
Getting Started
Quick Setup
- Download
Placy.jarfrom the releases page - Run:
java -jar Placy.jar - Open http://localhost:8080 in your browser
Basic Usage
API Usage
curl -X POST http://localhost:8080/api/v1/transform \
-F "file=@myfile.jar" \
-F 'placeholders={"${VERSION}":"1.0.0"}'Supported Files
- Archives: ZIP, JAR, WAR, TAR, 7Z
- Documents: DOCX, PDF (basic)
- Images: JPEG, PNG (metadata only)
- Text: All text-based files
Configuration
Set environment variables as needed:
export SERVER_PORT=8080
export SECRET_KEY=optional-api-keyKnown Limitations
- Large files (>1000MB) may cause memory issues
- PDF support is basic text replacement only
- No advanced security features yet
- Single-threaded processing
Requirements
- Java 17+
- 2GB RAM recommended
License
MIT License - see LICENSE file for details.