moner.ooo/README.md

Moner.ooo

Moner.ooo is a web application for converting Monero (XMR) to various fiat currencies and vice versa. It provides almost real-time exchange rates and supports multiple languages based on the user's browser settings.

This is a fork of the original project by nice42q with some modifications, including:

• Improved webpack configuration.
• Support for JS-less operation.
• Improved translations and translation handling.
• Automatic exchange rate updates.
• Automatic update of available currencies.
• Configuration file for customizing the application.

Table of Contents

• Features
• Usage
• Installation
• Configuration
• Development
• Contributing
• Acknowledgements

Features

• Conversion between Monero (XMR) and multiple fiat currencies.
• Multi-language support.
• User-friendly interface.
• Fetches currencies and exchange rates from CoinGecko API.
• Fully functional without JavaScript. Even better with JavaScript enabled.
• Customizable configuration.

Usage

Convert XMR to Fiat

To convert XMR to a fiat currency, simply visit:

https://monerooo.private.coffee/?in=USD

Replace USD with your preferred currency code. You can also specify the amount of XMR to convert:

https://monerooo.private.coffee/?in=USD&xmr=1

The xmr parameter specifies the amount of XMR to convert.

Convert Fiat to XMR

To convert a fiat currency to XMR, visit:

https://monerooo.private.coffee/?in=USD&fiat=1&direction=1

The fiat parameter specifies the amount of fiat currency to convert. The direction parameter is set to 1 to indicate conversion from fiat to XMR.

Use XMR Prices Data in Office Applications

1. Select field A1.
2. Go to Data → Link to external data....
3. Input the URL https://moner.ooo/ and confirm.
4. Confirm the import options and select HTML_1.

For an example, see kuno.anne.media.

Installation

Prerequisites

• PHP
• Node.js and npm
• PHP-enabled web server (e.g. Caddy, Nginx, Apache)

Steps

1. Clone the repository:

   git clone https://github.com/nice42q/moner.ooo.git
   cd moner.ooo
   

2. Install JavaScript dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Point your web server to the repository directory.

Configuration

Create a config.php file in the root directory to customize the application. Example:

<?php
return [
    'servers_guru' => false,
    'attribution' => 'Powered by Moner.ooo',
    'preferred_currencies' => ['USD', 'EUR', 'GBP'],
    'github_url' => 'https://git.private.coffee/kumi/moner.ooo/',
    'footer_links' => [
        ['url' => 'https://example.com', 'text' => 'Example Link']
    ],
];

Fetching Exchange Rates

Exchange rates are fetched from the CoinGecko API. The coingecko.php file handles the API requests and attempts to update exchange rates every 5 seconds. Due to the rate limits of the CoinGecko API, actual update intervals may vary and are closer to 60 seconds.

Contributing

We welcome contributions! Here’s how you can help:

1. Fork the repository.

2. Create a new branch for your feature or bugfix:

   git checkout -b my-feature-branch
   

3. Make your changes.

4. Commit your changes:

   git commit -m "Description of my changes"
   

5. Push to the branch:

   git push origin my-feature-branch
   

6. Create a pull request.

Acknowledgements

• Bootstrap
• CoinGecko API