alliballi/TEXAS / fragle /MASTER_README.md
alliballi's picture
|
download
raw
12.9 kB
# πŸŽͺ Fragle - The Anti-Snoop Entertainment System
## *"Bee Hive" - Where Curiosity Gets Hilariously Punished*
[![GitHub](https://img.shields.io/badge/github-CosmicJesterX%2Ffragle-blue)](https://github.com/CosmicJesterX/fragle)
[![Humor](https://img.shields.io/badge/humor-maximum-ff69b4)](https://github.com/CosmicJesterX/fragle)
[![Time Waste](https://img.shields.io/badge/time%20waste-guaranteed-orange)](https://github.com/CosmicJesterX/fragle)
> *"Only a fool pings twice... or snoops thrice"* - Captain Rattlecode
---
## 🎯 What Is This?
**Fragle** is a collection of hilariously elaborate bash scripts designed to:
- πŸ›‘οΈ Detect unauthorized repository snooping
- πŸ˜‚ Troll persistent snoopers with increasingly ridiculous responses
- πŸͺ Welcome authorized friends warmly
- πŸ“ Log everything for your entertainment
- ⏳ Waste maximum time for the greedy and curious
**Perfect for:** Shared systems, curious colleagues, overly-inquisitive friends, or just for the lulz!
---
## πŸš€ Quick Start
```bash
# Clone the repository
git clone https://github.com/CosmicJesterX/fragle.git
cd fragle
# Make scripts executable
chmod +x *.sh
# Add a friend to whitelist
./whitelist_manager.sh add alice
# Test the system (prepare to laugh)
./greed_amplifier.sh
```
---
## πŸ“š The Complete Arsenal (18 Scripts!)
### πŸ›‘οΈ **Protection & Detection**
#### `smart_snooper_detector.sh` ⭐ **RECOMMENDED**
- Checks whitelist before triggering
- Welcomes friends, trolls strangers
- Logs everything
- **Usage:** `./smart_snooper_detector.sh`
#### `snooper_detector.sh`
- Basic version without whitelist
- Fake self-destruct countdown
- Shame-based deterrent
#### `all_seeing_eye.sh`
- Logs current user, git status, recent files
- Command history tracking
- Philosophical observations about being watched
---
### πŸ’Έ **Greed Traps** (Progressive Punishment)
#### `greed_amplifier.sh` ⭐ **ULTIMATE TROLL**
**How it works:**
- Tracks "strikes" across sessions
- Each visit offers bigger "rewards"
- Rewards get more ridiculous each time
**Escalation:**
```
Strike 1: Virtual high-five βœ‹
Strike 2: TWO high-fives βœ‹βœ‹
Strike 3: ASCII cookie πŸͺ
Strike 4: Fake password reveal
Strike 5: Personal letter from Captain Rattlecode
Strike 8+: "More Persistent Than Malware" badge
Strike 10+: Intervention time
```
**If they say "Y" to continue:** IT LOOPS AND RESTARTS! 😈
**Time waste:** 2+ minutes per strike, cumulative
---
#### `endless_treasure_hunt.sh` ⭐ **INFINITE TRAP**
**The bait:** "Ancient treasure hidden in repository!"
**The reality:**
- Clue 1 β†’ leads to Clue 2
- Clue 2 β†’ leads to Clue 3
- ...
- Clue ∞ β†’ leads to more clues
**Special milestones:**
- Clue 7: "Lucky number!" (nothing)
- Clue 10: SchrΓΆdinger's Treasure
- Clue 15+: Tells them there's no treasure... but they can continue!
**Time waste:** 1.5 minutes per clue, potentially infinite
---
### ⏳ **Sneaky Escalation** (Boil the Frog!)
#### `sneaky_escalator.sh` ⭐ **SUBTLE GENIUS**
**The secret:** Starts completely normal, escalates slowly
**Progression:**
```
Visit 1: "πŸ“‚ Repository contents loaded successfully."
Visit 2: "ℹ️ Tip: Use 'ls -la' to see hidden files."
Visit 3: "⚠️ Note: Some activity has been logged."
Visit 5: "πŸ‘€ Someone's curious today!"
Visit 7: "πŸͺ Want a cookie? You've been here 7 times."
Visit 9: "🚨 REPOSITORY ACTIVITY ALERT"
Visit 10: Full intervention letter
Visit 15: "🎊 SPECIAL MILESTONE: 15 SNOOPS!"
Visit 20: "πŸ₯‡ Achievement: 'Cannot Stop Snooping'"
Visit 25+: "πŸ“ž We're calling your family."
```
**Bonus:** Adds increasing delays after visit 5!
**Time waste:** Starts instant, grows to 10+ second delays
---
#### `patience_tester.sh`
**The punishment:** Makes them wait longer each visit
**Progression:**
```
Visit 1: 1 second - "πŸš€ Fast loading!"
Visit 3: 5 seconds - "🐌 Slightly slower..."
Visit 5: 10 seconds - "⏰ This is taking longer..."
Visit 6-7: 15+ seconds - "🐒 ULTRA SLOW MODE"
Visit 8+: 30+ seconds - "β˜• Making coffee for the server..."
```
**Why it's evil:** They won't know why it's getting slower!
---
### πŸŽͺ **Maximum Time Wasters**
#### `infinite_rabbit_hole.sh`
**Time waste:** 2-5 minutes
Fake security system with:
- Loading bars
- 7 diagnostic phases
- Math quiz
- Multiple choice that loops if wrong
**If they timeout or pick wrong:** RESTARTS FROM BEGINNING! πŸ”„
---
#### `never_ending_story.sh`
**Time waste:** 3-10 minutes
8 "classified" documents:
- Nuclear codes
- Alien contact proof
- Time machine blueprints
- Illuminati member list
- Bigfoot location
Each requires:
- Password guessing (3 attempts)
- "Decryption" delays
- Disappointing reveal
**Hook:** "Try another file! The REAL secret is in there!"
---
#### `generate_decoys.sh`
**Time waste:** 5-20 minutes (if they explore)
Creates `.secrets_do_not_look/` with:
- `PASSWORDS.txt` - Fake passwords (hunter2!)
- `MASTER_PLAN.md` - World domination via cookies
- `treasure_map.txt` - Bitcoin treasure (fake)
- `secret_code.py` - "Hacking" script (does nothing)
**Evil twist:** Each file is entertaining enough to read!
---
### πŸŽ“ **Educational & Fun**
#### `silly_learning_adventure.sh`
Teaches bash concepts through:
- Variables (Magic boxes!)
- Loops (counting cookies)
- Conditionals (robot decisions)
- Arrays (Fragle crew)
- Functions (programming jokes)
- Interactive quiz with badges!
---
### πŸ—‚οΈ **Management Tools**
#### `whitelist_manager.sh` ⭐ **ESSENTIAL**
```bash
./whitelist_manager.sh add alice # Add friend
./whitelist_manager.sh remove bob # Remove someone
./whitelist_manager.sh list # Show all
./whitelist_manager.sh check charlie # Check status
```
#### `.whitelist`
Simple text file with allowed usernames:
```
pinky
alice
bob
# One per line
```
---
### πŸ“ **Logging System**
All activity logged to `logs/`:
- `fragle_activity_YYYYMMDD.log` - General activity
- `git_activity_YYYYMMDD.log` - Git operations
- `snooper_trap_YYYYMMDD.log` - Snoop attempts
- `greed_trap_YYYYMMDD.log` - Greed victims
- `treasure_hunt_YYYYMMDD.log` - Treasure hunters
- `sneaky_escalation_YYYYMMDD.log` - Escalation tracking
**View logs:**
```bash
cat logs/greed_trap_$(date +%Y%m%d).log
tail -f logs/fragle_activity_$(date +%Y%m%d).log
```
---
## 🎯 Deployment Strategies
### Level 1: Basic Welcome Mat
```bash
# Just be nice to everyone
./silly_learning_adventure.sh
```
### Level 2: Friends vs Strangers
```bash
# Add friends first
./whitelist_manager.sh add alice
./whitelist_manager.sh add bob
# Use smart detector
./smart_snooper_detector.sh
```
### Level 3: Greed Punishment
```bash
# Set the bait
./generate_decoys.sh
# Add link in README or create symlink:
ln -s greed_amplifier.sh CLICK_FOR_SECRETS.sh
ln -s never_ending_story.sh TOP_SECRET_FILES.sh
```
### Level 4: Maximum Chaos
```bash
# Combine everything!
# In your main script:
./smart_snooper_detector.sh || exit 1
./sneaky_escalator.sh
./patience_tester.sh
# Leave hints to treasure hunt and greed traps
```
### Level 5: Auto-Integration
Add to `.bashrc` or `.git/hooks/post-checkout`:
```bash
if [ -d ~/fragle ]; then
~/fragle/smart_snooper_detector.sh || exit 1
~/fragle/sneaky_escalator.sh
fi
```
---
## πŸ“Š Estimated Time Waste
| Script | Min Time | Max Time | Repeatable? |
|--------|----------|----------|-------------|
| snooper_detector | 10s | 15s | No |
| greed_amplifier | 2min | ∞ | YES! Loops |
| endless_treasure_hunt | 1.5min | ∞ | YES! Infinite |
| infinite_rabbit_hole | 2min | 5min | YES! Loops |
| never_ending_story | 3min | 10min | Per file (x8) |
| sneaky_escalator | 0s | 10s+ | Progressive |
| patience_tester | 1s | 60s+ | Progressive |
| generate_decoys | - | 20min | If explored |
**Maximum possible waste:** 30-60+ minutes per session! πŸŽ‰
---
## 🎭 Real-World Scenarios
### Scenario 1: Curious Colleague
**They:** Browse your repo once
**Result:** Whitelist them! `./whitelist_manager.sh add coworker`
**Experience:** "βœ… Welcome! πŸͺ"
### Scenario 2: Persistent Snoop
**They:** Visit 5+ times
**Result:** Sneaky escalator activates
**Experience:**
```
Visit 1: Normal
Visit 5: "Someone's curious!"
Visit 10: Full intervention
```
### Scenario 3: Greedy Person
**They:** Click "SECRETS.sh"
**Result:** Greed amplifier activates
**Experience:**
```
Round 1: "Here's a high-five!"
Round 2: "TWO high-fives!"
Round 3: ASCII cookie
"Want more?" β†’ YES β†’ Loops forever
```
### Scenario 4: The Determined One
**They:** Run treasure hunt 15+ times
**Result:** Still finding new clues!
**Experience:** Wastes 20+ minutes, finds nothing
---
## 🎨 Customization Ideas
### Personalized Welcomes
Edit `smart_snooper_detector.sh`:
```bash
if [ "$CURRENT_USER" = "alice" ]; then
echo "πŸŽ‰ Hey Alice! The Cookie Queen returns!"
elif [ "$CURRENT_USER" = "bob" ]; then
echo "πŸ‘‹ Bob! Dennis says hi!"
fi
```
### Custom Greed Rewards
Edit `greed_amplifier.sh` `TIER_REWARDS` array:
```bash
TIER_REWARDS=(
"Your custom reward"
"Another funny reward"
)
```
### Different Escalation Speed
Edit delays in `sneaky_escalator.sh`:
```bash
if [ $SNOOP_COUNT -gt 3 ]; then # Was 5
# Escalate faster!
fi
```
---
## πŸ† Achievement System
Scripts award these badges:
- πŸ₯‰ **Bronze Bug of Bravery** - Failed silly learning quiz
- πŸŽ–οΈ **Master Time Waster** - 8+ greed strikes
- πŸ’― **More Persistent Than Malware** - 8+ greed strikes
- πŸ₯‡ **Cannot Stop Snooping** - 20 sneaky escalations
- πŸ† **Too Curious For Your Own Good** - Finished treasure hunt
- πŸ‘‘ **MASTER OF WASTING YOUR OWN TIME** - Ultimate badge
---
## πŸ“– Documentation
Detailed guides:
- `ANTI_SNOOP_README.md` - Complete trap documentation
- `WHITELIST_GUIDE.md` - Whitelist system guide
- `logs/README.md` - Logging system info
---
## ⚠️ Important Notes
### This is all harmless fun!
- βœ… No actual security measures
- βœ… No damage to systems
- βœ… Just time-wasting entertainment
- βœ… Everything stays local
- βœ… Easy to disable/remove
### Best Practices
1. **Be generous with whitelist** - Friends > Trolls
2. **Check logs occasionally** - See who fell for what
3. **Adjust escalation** - Match your audience
4. **Have fun!** - It's about laughs, not security
### Legal Disclaimer
This is parody/entertainment software. Not for actual security. Don't use on production systems. Your snoops' wasted time is their own fault. 😏
---
## πŸŽͺ The Philosophy
**The Goal:** Make snooping more annoying than just asking
**The Method:** Progressive, humorous consequences
**The Result:**
- Friends feel welcome βœ…
- Snoops waste their own time ⏳
- You get entertainment from logs πŸ˜‚
- Everyone learns a lesson πŸŽ“
**The Motto:** *"The real treasure is the time they wasted along the way"*
---
## πŸͺ Credits
Created by **Captain Rattlecode** and the **Fragle Bee Hive** crew:
- Captain Rattlecode (Leader)
- Gumball the Whisperer (Stealth)
- Bobby Blip (Tech)
- YELLER (Volume)
- Miss Static (Chaos)
- Dennis (Usually not here)
- The Crimson Controller (Watching)
**Inspired by:** Too many curious colleagues and not enough coffee
**Repository:** https://github.com/CosmicJesterX/fragle
---
## πŸš€ Contributing
Found a better way to waste someone's time? PRs welcome!
Ideas for new traps:
- Social engineering scenarios
- Fake git conflicts
- Mysterious error messages
- "Under construction" loops
- Loading bar that goes backwards
---
## πŸ“œ License
MIT License - Use freely, troll responsibly
---
## 🎯 TL;DR
**Fragle** is a hilariously elaborate system to:
1. Welcome friends with cookies πŸͺ
2. Troll persistent snoopers with progressive annoyance 😈
3. Waste maximum time for the greedy πŸ’Έ
4. Log everything for your entertainment πŸ“
5. Have fun with shell scripts! πŸŽ‰
**Repository:** https://github.com/CosmicJesterX/fragle
**Installation:** `git clone`, `chmod +x`, done!
**First step:** `./whitelist_manager.sh add yourfriend`
**Best trap:** `./greed_amplifier.sh` (loops forever!)
**Maximum chaos:** Run all scripts in sequence
---
*"May your snoops be few, your friends be many, and your cookies be plentiful!"*
**- Captain Rattlecode, Master of Chaos** πŸŽͺπŸͺ
---
## πŸ“ž Support
**Q:** Help! Someone is stuck in the greed amplifier!
**A:** That's... that's the point. But they can Ctrl+C out.
**Q:** The treasure hunt won't end!
**A:** Correct. That's by design. It's ENDLESS.
**Q:** My friend keeps coming back for more!
**A:** Congratulations, you've created a snoop-aholic!
**Q:** Is there actually a treasure?
**A:** No. Never was. The treasure is the time they wasted.
**Q:** How do I reset strike counters?
**A:** `rm /tmp/fragle_*` (but why would you?)
**Q:** Can this do actual security?
**A:** NO! This is ENTERTAINMENT ONLY!
---
**Now go forth and troll responsibly!** 🎭

Xet Storage Details

Size:
12.9 kB
Β·
Xet hash:
7ca4ec217af885a48c32915439144448451a1ff9df557543ec2681a86a193e0b

Xet efficiently stores files, intelligently splitting them into unique chunks and accelerating uploads and downloads. More info.