RtMoR

_Real-time Modification of Requests_
- github.com/Adrosar/rtmor
- bitbucket.org/Adrosar/rtmor

RtMoR is alternative to Requestly

- requestly.io _(new website)_
- www.requestly.in _(old website)_

Why do I need RtMoR?

If you are working on an application in React, Angular, VueJS, you will definitely appreciate RtMoR. See the problem below that RtMoR is solving.

$3

You need to debug your JavaScript application in production. Unfortunately, you cannot make a copy of such an environment and nor can you access JS scripts on the server.

Thanks to RtMoR, you can redirect the selected resource request to the local server.

!rtmor-scheme-307

So you can safely work in the production environment.

Examples (Linux, bash)

Remember to build a project!
``bash
./scripts/dist.sh
`
_( ↑ Script dist.sh uses the GO compiler - recommended version: 1.15.6 )_


Show help:

`bash
./build/linux-amd64/rtmor -help
`

Run proxy server that is listening on all network interfaces:
`bash
./build/linux-amd64/rtmor -start -listen 0.0.0.0:8888 -log BMW
`

Run with a configuration containing sample rules:
`bash
./build/linux-amd64/rtmor -start -listen 0.0.0.0:8888 -cfg ./configs/sample.yaml -log BMW
`

$3

The configuration file contains examples of using RtMoR → ./configs/sample.yaml

Examples (Windows, cmd)

Remember to build a project!
`
scripts\dist.cmd
`
_( ↑ Script dist.cmd uses the GO compiler - recommended version: 1.15.6 )_

Run with a configuration containing sample rules:
`
build\windows-amd64\rtmor.exe -start -listen 0.0.0.0:8888 -cfg configs\sample.yaml -log BMW
`

HTTPS and Certificate

For HTTPS redirection to work, install the certificate on the device.

$3


- ./assets/ca-root/ca.crt
- ./assets/ca-root/ca.pem

The certificate comes from elazarl/goproxy

> How do install a root certificate in Linux _(Ubuntu, Linux Mint)_
> https://askubuntu.com/questions/73287/how-do-i-install-a-root-certificate
> ( screenshot )

Runnable binaries

Download a copy of the repository and binaries ready to run.

NPM

$3

Build package for NPM:

`bash
./scripts/dist.sh && npm pack
`

Install rtmor package from file:
`bash
npm install -g ./rtmor-0.6.1.tgz
`

$3

`bash
npm install -g rtmor
``
_( ➥ npmjs.com/package/rtmor )_

RtMoR installed with NPM includes binary files compiled for systems:

- Windows 10 (64-bit & 32-bit)
- Linux (64-bit & 32-bit)
- MacOS (64-bit, intel)

License

I put the software temporarily under the Go-compatible BSD license. If this prevents someone from using the software, do let me know and I'll consider changing it.

The software uses repositories:

- github.com/elazarl/goproxy _(Go-compatible BSD license)_
- github.com/go-yaml/yaml _(Apache License 2.0)_
- github.com/fatih/color _(MIT License)_

Early stage

The software was created for personal use and is in the early stages of development, so CLI is subject to change.

Author

Adrian Gargula | github.com/Adrosar | bitbucket.org/Adrosar