💀 H.M.A.S – Hacker Message As Service

🟢 Active Users Online: 339










                                 ### 🚀 H.M.A.S. Hacker Messages As Service
                                             
                                           ## 🧾 Summary Table

    Parameter                                 Description                                      
|---------------|----------------------------------------------------------------------------------|
| `msg=`        | Fetch themed hacker messages                                                     |
| `as=`         | Custom label for sender                                                          |
| `talk=on`     | Enable default system analysis                                                   |
| `talk=`       | Custom responder name                                                            |
| `talkcolor=`  | Custom color text                                                                |
| `chat=on`     | Enable chat-style replies | chatstyle must be together with chat=on              |
| `chatstyle=`  | Tone for chat replies  | casual, sarcastic, panic, neutral and misc              |
| `search=`     | Look up message contents                                                         |
| `color`       | Custom color | html only                                                         |
| `alerts`      | Synthetic cybersecurity alerts                                                   |
| `types`       | types=on list all alert types                                                    |
| `severity`    | alerts severity | hight medium critical low                                      |
| `diff=`       | Compare keywords |diff=awk+bash                                                  |
| `diffmode=`   | Styled Responses | classic , strike, redacted, corrupt, delta and tagged         |
| `scenario=`   | Retrieve cheat-sheet real commands                                               |
| `format=`     | Output style (json, txt, html, md, yaml)                                         |
| `share=`      | Email the message                                                                |
| `mode=`       | Daily/weekly rotation mode                                                       |
| `category=`   | Choose a message theme | list categories api.php/categories.php                  |
| `like`        | Mark the last message as favorited                                               |
| `liked`       | Retrieve Liked Messages                                                          |
| `page`        | Navigate trough pages | &page=1                                                  |
| `send`        | Send Encrypted Messages Between Users  send=hello&rec=user-pub-key&selfdestruct=1|
|               |  go to hmas/secure.php to generate your keys                                     |
| `inbox`       | Read Encrypted Messages ?inbox=read | ?inbox=delete&id= |delete messages         |
|               |  Use your secret key to read and delete messages                                 |
| `share`       | Share any Option to any Email Address                                            |
| `ai`          | simulate responses to real system logs or events                                 |
| `threads`     | generate multiple messages and AI responses in sequence(ai= only)                |
| `seeded`      | Contextual AI Replies (ai= only)                                                 |
| `usage`       | Retrieve your api usage api.php?usage&apikey                                     | 
| `help`        | Prints this help usage api.php?help&apikey                                       |
                     ℹ️  Tip: Generate your public and secret keys at /hmas/secure.php
                     🔐  Send and read encrypted messages at /hmas/inbox.html

                                              Happy hacking! 💻🧑‍💻

For tips and tricks follow the Blog.



# 🎉 New Feature: Chat with Style! 🗨️💬

Check the Blog for More!!



GET Request Format:
    /api.php?msg=Hacker&apikey=YOUR_API_KEY | where Hacker becommes your User ID.

    ## Free API= testkey123 |  Kittens will die if you abuse this service.
  
OR for Output Formats:
  
    /api.php?msg=Hacker&format=json&apikey=YOUR_API_KEY | For now you can use testkey123 
      untill are api calls available.

Response:
    {
        "message": "🧠 Captain! Almost your devices are hacked...",
        "user": "hacker"
    }

  Optional Format Parameter:
    &format=json     → Default JSON (structured API use)
    &format=txt      → Plain text (shell output, minimal)
    &format=html     → Styled HTML (embed in dashboards/web UIs)
    &format=yaml     → YAML (DevOps tools, config generation)
  

 🖥️ Use H.M.A.S. from Your Terminal
   ---------------------------------------
   You can fetch messages directly from the command line using our official CLI:

    npx hmas-cli --msg hacker --format txt --apikey YOUR_API_KEY

   Supports all API options:
   - --msg: Your message context
   - --format: json, txt, yaml, html, md
   - --category: ai, debug, terminal, etc.
   - --mode: daily or weekly rotation
   - --apikey: Pass securely via flag or HMAS_APIKEY env var

   Examples:
   npx hmas-cli --msg ghost --format md --mode daily --apikey YOUR_API_KEY
   HMAS_APIKEY=YOUR_API_KEY npx hmas-cli --msg hacker --format yaml

   Run instantly with npx:
   npx hmas-cli --msg hacker --format txt --apikey YOUR_KEY

   Or install globally for frequent use:
   
   mpm install -g hmas-cli
   
   hmas --msg hacker --format yaml --apikey YOUR_KEY

   🧱 CommonJS

   const hmas = require('hmas-cli');

   hmas({ msg: 'cyberpunk', format: 'json', apikey: 'YOUR_KEY' })
     .then(res => console.log(res));


   🌐 ESM / Modern Node

    import hmas from 'hmas-cli';

    const res = await hmas({ msg: 'ai', format: 'yaml', apikey: 'YOUR_KEY' });
    console.log(res);


    🛠 TypeScript Support

     import hmas from 'hmas-cli';

     const result = await hmas({ msg: 'fun', format: 'json', apikey: 'YOUR_KEY' });

   
##NEW

## ❤️ Like It? Save It.
Yes, you can now show your love! Every time you retrieve a message 

using `msg=`, `as=`, or even `search=`, the last one can 

be *liked* or *disliked* — just like your favorite cat video 🐾.

### Submit Feedback

```http
api.php?last=like&apikey=YOUR_KEY
api.php?last=dislike&apikey=YOUR_KEY
```

Likes are stored in your personal memory vault. Dislikes? Well, let's just say 

the system will *"consider it for review"* 

— which is intern-speak for "buried under the cyber rug."

---

## 🔁 Retrieve Your Liked Messages

```http
api.php?liked&apikey=YOUR_KEY
api.php?liked&max=5&page=2&format=markdown&apikey=YOUR_KEY
```

### Parameters
- `max` (1-10): How many to fetch
- `page`: Which page of results
- `format`: json, html, md, yaml, txt (we’re format-flexible)

---

### Example
```http
api.php?liked&page=1&format=html&apikey=testkey123
```

Will return something heartwarming like:
```html
❤️ 🧠 Captain! A phantom process is scraping your clipboard history.
❤️ 📡 AI Guardian detected entropy drift. Bucket reversed.
```

---

Now your HMAS memories can last a little longer 💾✨.





🧾 Advanced: Custom User Labels with as=

  You can now use the as= parameter to override the default "user" label or completely replace it in all 
  response formats.

   GET /api.php?as=system&apikey=YOUR_KEY

   Response:

   {
     "system": "🧠 Some generated message."
   }

   This minimal form also applies to all formats:



    
# 📡 HMAS API - Share, Search, and Paginate Messages

The HMAS API now includes powerful new features to search messages, share results via email, and control pagination. These enhancements make it easier to find and deliver relevant content directly to users or collaborators.

---

## 🔍 Search Messages

You can search stored messages using the `search` parameter. The query will look for matches in message content stored in the database.

### Example:

```
api.php?search=memory&apikey=YOUR_API_KEY
```

This returns messages containing the word `memory`.

You can also include Categories like always

### Additional Options:

- `max=`: Limit the number of results (1 to 10)
- `format=`: Choose response format (`json`, `html`, `markdown`, `text`, `yaml`)
- `page=`: Paginate results (e.g. page 1, 2, etc.)

### Example with Pagination and Format:

```
api.php?search=memory&max=3&page=2&format=markdown&apikey=YOUR_API_KEY
```

---

## 📬 Share Results via Email

You can share **any** message or search result using the `share` parameter.

### Example: Share a Named Message

```
api.php?msg=john&format=html&share=you@example.com&apikey=YOUR_API_KEY
```

You can also include Categories like always

### Example: Share a Search Result

```
api.php?search=quantum&max=5&page=1&format=markdown&share=colleague@lab.net&apikey=YOUR_API_KEY
```

### What You Get

- 🎨 A nicely formatted email with the result
- ✅ UTF-8 safe output (supports emojis and international text)

---

## 🛠️ Format Options

Use `format=` or `as=` or `msg=`to customize the response output.

- `json` (default)
- `html`
- `markdown`
- `yaml`
- `text` or `txt`

---


## 🚀 Try It Now

```
api.php?search=surveillance&format=html&share=friend@cyberspace.net&page=1&max=2&apikey=YOUR_API_KEY
```
You can also include Categories like always

Spread the intelligence. Share the signal.





   Integration Ideas:
                🔒 NATIONAL INFRASTRUCTURE MONITORING NODE
                ===========================================
              ☠️ Your access pattern matches a known threat vector.
🛑                   DHS/NSA/ECHELON trace initialized.
👁️                   Expect a visit within 24–48 hours.

    - Command line tools (curl, bash aliases, hacker CLI fun).
    - Mobile apps (React Native, Android, iOS).
    - Discord/Slack bots (inject chaos into chat).
    - Browser extensions or overlays (for the paranoid developer).
    - Game overlays, status dashboards, terminals, code intros.
    - Dev humor widgets for launch screens and error pages.

📌 Features:
    - Fully  hacker-style JSON API.
    - Just send your request. Get a surprise. No input, no UI.
    - Every response is randomized. Inject some cyber-chaos.
    - Supports emojis and dramatic, immersive phrasing.
    - Works great in side projects, serious projects, or memes.
    - More 128.000 messages to be sure your chaos never ends.


  Daily / Weekly Rotating Modes
    → mode=daily: Same message for all users each day
    → mode=weekly: Same message for the week
    → Example:
      /api.php?msg=test&mode=daily&apikey=yourkey
      /api.php?msg=test&mode=weekly&category=debug&apikey=yourkey


   Now with Category Filtering!
    ---------------------------------------
    - Use ?category=ai or ?category=cyberpunk to limit message themes.
    - Try: /api.php?msg=hacker&category=fun
    - Use /categories.php to list available categories.

📂     Categories include:
      ai, cyberpunk, terminal, debug, fun, hacker and misc.

    🎮 Pranks Collection: Fun Messages to Mess with Your Friends! 🤖

      Welcome to our Prank Generator! Whether you're a mischievous hacker or just looking to spice up your day, 
      our prank messages are sure to entertain. From hilarious cyber threats to playful system alerts, 
      we've got you covered. 
      These messages are perfect for sending a little surprise to your friends or even creating hilarious,
      pranks for a good laugh.
     
      Here's how it works:

      Prank Generator: Simply choose your prank and share it.

      Customizable Messages: Tweak the message to match your prank style. 
      Want it to sound like a terminal command? Done. How about a hacker alert? We've got you.

      Dynamic Alerts: Get a new prank message every time you refresh or select a different option.

🚨    Warning: Use these pranks responsibly — don't cause harm, just some good-natured fun!

     
     🧩 Embed the Hacker Terminal Widget on Your Site  
      -----------------------------------------------

     Easily display real-time hacker-style messages on your website using our embeddable widget.

     Just copy and paste the following into your HTML page:

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

               

     Parameter Rules:
     - ?as=john  result: john + message
     - ?msg=john result: user:john + message
     - Allowed: a-z, A-Z, 0-9, _, -, and space.
     - Max 50 characters.