Marinette

May 17, 2026 ยท View on GitHub

Marinette.png

A set of 5hell configuration files written entirely in Glosure!

TL;DR An installation how-to for those who can't wait! ๐Ÿ‘€

I know this README is a little bit of a mess, so I've compiled the most interesting and important parts of this repository here for both your and my convenience โค๏ธ

What is even this?

It's Marinette - the addition to your 5hell's rkit/do.rc, written entirely in Glosure! ๐Ÿ˜œ

Why Marinette?

Marinette is named in honor of Marinette Dupain-Cheng, my favourite character of the Miraculous: Tales of Ladybug & Cat Noir series! ๐Ÿž

What is 5hell?

5hell is an awesome shell emulator and multitool by the fabulous Plu70, which you can use and tinker on for absolutely free! ๐ŸŽ

What is rkit/do.rc?

It's like .bashrc, but for 5hell!

If you have absolutely no idea what .bashrc is, not a single clue about how do.rc works and don't feel like reading through a whole lot, no worries! ๐Ÿคญ

In simple words, do.rc is simply a file with a set of commands that gets executes every time you launch 5hell ๐Ÿงพ

If you would like to learn more in detail about how it works, refer to the documentation here, or simply issue help -s do.rc command while running the 5hell herself ๐Ÿฅฐ

What and why is Glosure?

Glosure is the first ever publicly available interpreted lisp-like language for Grey Hack by the gorgeous mahocitrus, which 5hell supports fully and without any restrictions! ๐Ÿ˜ƒ

It allows everything do.rc scripitng allows plus everything in-game scripting allows! Which opens endless possibilities with what you can implement in a configuration files, really! ๐ŸŒบ

Do I need to know Glosure to use this?

Absolutely no! Marinette doesn't require any Glosure knowledge for you to use her. However, if you want to modify something or write your own Glosure scripts, you, of course, would make use of Glosure ๐Ÿ˜‰

How can I write my own scripts or modify the config?

For now, you can write your own script only by reading the Glosure tutorial and checking the scripts in bonus

There is also a reference that covers everything 5hell/Marinette specific ๐Ÿ˜Œ

However, modifying do.gls is as easy as just commenting out something or simply following the instructions in the comments!

Why would I want to use Marinette?

Because just as 5hell, Marinette is completely free to use and to tinker on! ๐Ÿ’…

Not only that, but Marinette:

  • Adds many usefull commands and macros ๐Ÿ–ฅ
  • Adds support for personalization ๐ŸŒผ
  • Assists you in hacking ๐Ÿ•ต๏ธ
  • Is easy to install and use โ˜˜๏ธ
  • Is fully compatible with the do.rc you already have ๐Ÿ‘€
  • Loves all of you! ๐Ÿ’

Okay, you definitely bought me! How can I install Marinette?

Awesome! Can't wait for it! ๐Ÿ˜„

To install Marinette, follow these simple instructions:

  1. Ensure you have /root/rkit/do.rc file. If you haven't, issue kore -r as root. Skip tables generation as it will make the process A LOT longer! โณ
  2. Add these simple lines at the end of do.rc ๐Ÿ“
  3. Close 5hell and run her again. This will generate marinette folder structure in your /root/rkit/ ๐Ÿ—‚
  4. Go to /root/rkit/marinette/glosure and paste in 5hell.gls, do.gls, marinette.gls, one by one โœ๏ธ
  5. Close 5hell and run her again ๐Ÿ’ป

After this, you may want to copy over /root/rkit/marinette/ascii.txt as well as /root/rkit/marinette/themes/soft.src for a bit of personalization ๐Ÿ™‚

You may as well use minified releases for a bit faster startup times ๐Ÿ‘€

Or, if you're feeling adventurous, you can try an alternative way, using Greybel-JS:

  1. Repeat steps 1 and 2 from the above ๐Ÿ‘†
  2. Download the source code of Marinette to your computer and unarchive it ๐Ÿ“š
  3. Enter the directory where do.rc is stored ๐Ÿ“
  4. Issue greybel import glosure -id /root/rkit/marinette ; greybel import scripts -id /root/rkit/marinette ; greybel import themes -id /root/rkit/marinette in the console of your IRL computer ๐Ÿ’ป
  5. Close 5hell and run her again โœŒ๏ธ

Congratulatuons, Marinette is successfully installed as root! ๐Ÿ’ž

Now you may would want to do one of the following things:

  • Issue marinette to see the overall statistics ๐Ÿ“Š
  • Issue marinette additions to see what commands were added (issue a specific command with -h flag to get a help for it!) ๐Ÿงฐ
  • Issue marinette modifications to see what commands were changed ๐Ÿ”ฎ
  • Issue macros to see what macros were added ๐Ÿ“ผ
  • Change 5hell theme. Read themeing section in /root/rkit/marinette/glosure/do.gls and choose a theme from themes ๐Ÿ
  • Change Marinette ascii art at startup. Simply change the contents of /root/rkit/marinette/notepads/ascii.txt!
  • Place some scripts to /root/rkit/marinette/scripts for you to issue with %script-name ๐Ÿ“„
  • Get yourself a repository, some hacking binaries and an NPC proxy with setup-v3.gls ๐Ÿ‘€
  • Install Marinette as your user or as /bin/bash replacement with marinette-install-v2.gls ๐Ÿž

Happy hacking! ๐Ÿ‘พ

Doesn't sound convincing... Maybe I'll try it later...

No worries! And thanks for reading this far ๐Ÿ˜Œ

I still encourage you to check out these projects, though!

I've encountered a bug, please help!

Absolutely try these easy steps before reporting โœŒ๏ธ

  1. Rename all binaries with the name 5hell to something else, for example, 5hell.bak, or remove them from the machine entirely ๐Ÿ”
  2. Rename all folders with the name rkit to something else, for example, rkit.bak, or remove them from the machine entirely ๐Ÿ“
  3. Build the most recent 5hell from the upstream โœจ
  4. Create rkit folder in /root and create do.rc text file in it ๐Ÿ“„
  5. Begin the installation of Marinette from the step 2!!!

If the issue is resolved, chances are high that this has something to do with your setup! ๐Ÿ˜”

Update your 5hell on home, in rkit, on HOME server, on the targets you are attacking, and then do the same with Marinette!

The issue is still there? I will be more than happy if you tell me about it in the DM (my ID is not_s0phie) or the 5hell official discord server

When reporting a bug, be sure to include the output of shell || marinette!

Why there are SO many whys and whats?

Well, it's just because I felt like writing an entire novel in a single README file. Whoops!

I'm absolutely sure something is still missing in here... Guess we'll see! ๐Ÿ˜…

The people who made this possible!

Marinette wouldn't be possible without you! Big thanks to all of you! ๐Ÿ’–

You all are simply the best! ๐Ÿฅฐ

Afterword

I could forget to mention someone above, something can be broken, some link in the repository may lead to rickroll, all that thingies I overlooked, so if you find out something I can fix or help you with please let me know in the Discord (my ID is not_s0phie)! Thanks for your patience and for using this little project of mine! Lots of loooove! ๐Ÿ’•