Skip to content
This repository was archived by the owner on Nov 30, 2025. It is now read-only.

Version 1.0

Choose a tag to compare

View all tags
@Harfull Harfull released this 10 Sep 08:11
· 33 commits to main since this release
v1.0
0f732fb

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

  1. Download Placy.jar from the releases page
  2. Run: java -jar Placy.jar
  3. 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-key

Known 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.

Assets 3
Loading