💀 H.M.A.S
HACKER MESSAGE AS SERVICE
hmas@terminal:~
🚀 Quick Start
GET /api.php?msg=hacker&apikey=testkey123
Response:
{
"message": "🧠 Captain! Your system is compromised...",
"user": "hacker"
}
REST API
Access 128,000+ hacker-themed messages via simple REST calls. Perfect for dashboards, bots, and pranks.
CLI Tool
Use HMAS directly from your terminal with our official npx CLI. Install globally or run instantly.
Encrypted Messages
Send and read encrypted messages between users with PGP-style encryption.
AI Chat Mode
Simulate realistic AI responses to system logs with customizable tones and styles.
Search & Filter
Search messages by keyword, filter by category, and paginate results.
Like System
Save your favorite messages and retrieve them anytime from your personal collection.
Image Generation
Attach a generated image to any HMAS message with one extra parameter.
📚 Documentation
API Reference
CLI Usage
Output Formats
Categories
Advanced Features
Core API Endpoints
# Basic message request
curl "https://carlostkd.ch/hmas/api.php?msg=hacker&apikey=testkey123"
# With JSON format
curl "https://carlostkd.ch/hmas/api.php?msg=hacker&format=json&apikey=testkey123"
# With category filtering
curl "https://carlostkd.ch/hmas/api.php?msg=hacker&category=cyberpunk&apikey=testkey123"
# Search messages
curl "https://carlostkd.ch/hmas/api.php?search=memory&max=5&apikey=testkey123"
| Parameter | Description |
|---|---|
| msg= | Fetch themed hacker messages (becomes user label) |
| as= | Custom label for sender |
| format= | Output style: json, txt, html, md, yaml |
| category= | Message theme: ai, cyberpunk, terminal, debug, fun, hacker, misc |
| search= | Look up message contents by keyword |
| image= | Generate a image with your message (image=on or a custom prompt) |
| apikey= | Your API key (use testkey123 for free access) |
HMAS CLI Installation & Usage
# Run instantly with npx
npx hmas-cli --msg hacker --format txt --apikey YOUR_API_KEY
# Install globally
npm install -g hmas-cli
hmas --msg hacker --format yaml --apikey YOUR_KEY
# Node.js CommonJS
const hmas = require('hmas-cli');
hmas({ msg: 'cyberpunk', format: 'json', apikey: 'YOUR_KEY' })
.then(res => console.log(res));
# Node.js ESM
import hmas from 'hmas-cli';
const res = await hmas({ msg: 'ai', format: 'yaml', apikey: 'YOUR_KEY' });
console.log(res);
Output Formats
| Format | Use Case | Example |
|---|---|---|
| json | Default API use, structured data | &format=json |
| txt | Plain text, shell output | &format=txt |
| html | Embed in dashboards/web UIs | &format=html |
| yaml | DevOps tools, config generation | &format=yaml |
| md | Markdown documentation | &format=md |
Message Categories
AI
Artificial intelligence warnings and alerts
Cyberpunk
Futuristic hacker aesthetics
Terminal
Classic command-line messages
Debug
System debugging scenarios
Fun
Prank messages for friends
Hacker
Classic hacker-style alerts
Advanced Features
💬 Chat Style Mode
# Enable chat mode with custom tone
api.php?chat=on&chatstyle=panic&apikey=testkey123
# Available styles: casual, sarcastic, panic, neutral, misc
🖼️ Image Generation
# Generate an image from the HMAS message theme
api.php?msg=hacker&image=on&format=json&apikey=testkey123
# Generate an image from your own prompt
api.php?msg=hacker&image=neon%20cyberpunk%20fox&apikey=testkey123
# Response (json) includes an "image" object:
# image.url → full URL (cached 24 hours, then auto-deleted)
# image.ansi_preview → terminal-safe preview for txt/json
# image.prompt → the prompt sent to the AI
# txt format prints the URL + an ANSI art preview for terminals
api.php?msg=hacker&image=on&format=txt&apikey=testkey123
🛡️ Images are cached by prompt (dedup — repeat requests don't re-bill) and removed automatically after 24 hours to keep the server clean.
❤️ Like System
# Like your last message
api.php?last=like&apikey=testkey123
# Dislike
api.php?last=dislike&apikey=testkey123
# Retrieve liked messages
api.php?liked&max=5&page=1&format=html&apikey=testkey123
🔐 Encrypted Messaging
# Generate keys first
Visit: https://carlostkd.ch/hmas/secure.php
# Send encrypted message
api.php?send=Hello&rec=USER-PUB-KEY&selfdestruct=1&apikey=testkey123
# Read inbox
api.php?inbox=read&apikey=testkey123
api.php?inbox=delete&id=MESSAGE-ID&apikey=testkey123
📧 Share via Email
# Share any message or search result
api.php?msg=hacker&format=html&share=friend@example.com&apikey=testkey123
api.php?search=quantum&max=3&format=markdown&share=colleague@lab.net&apikey=testkey123
🔄 Rotation Modes
# Daily rotation - same message for all users each day
api.php?msg=test&mode=daily&apikey=testkey123
# Weekly rotation - same message for the week
api.php?msg=test&mode=weekly&category=debug&apikey=testkey123
🎯 Integration Ideas
Mobile Apps
React Native, Android, iOS integration
Chat Bots
Discord, Slack bots for chaos injection
Browser Extensions
Overlays for paranoid developers
Game Overlays
Status dashboards, terminals
📌 Embed Widget
Display real-time hacker messages on your website
<div id="hacker-terminal"></div>
<script src="https://carlostkd.ch/hmas/embed.js"
data-api="https://carlostkd.ch/hmas/api.php?msg=hacker&apikey=yourApi"></script>