No description
Find a file
2024-09-06 19:40:39 +00:00
img Added Servers Guru Logo 2024-07-11 16:16:44 +02:00
lang Merge remote-tracking branch 'upstream/main' 2024-08-30 10:23:27 +02:00
src Revert "chore: optimize CSS imports and PurgeCSS config" 2024-09-04 08:10:41 +02:00
templates refactor: move HTML to template file 2024-08-30 10:14:56 +02:00
.gitignore chore: update .gitignore for clarity and consistency 2024-08-08 16:07:32 +02:00
coingecko.php feat: improve API error handling & add exchange rate updates 2024-08-08 14:55:47 +02:00
config.dist.php Update config.dist.php 2024-09-06 19:37:44 +00:00
index.php index: update GitHub repository link 2024-09-06 19:40:39 +00:00
package-lock.json Revert "feat(build): optimize output with minification and compression" 2024-09-04 08:10:17 +02:00
package.json Revert "feat(build): optimize output with minification and compression" 2024-09-04 08:10:17 +02:00
README.md docs: update currency conversion URLs 2024-08-28 15:09:49 +02:00
webpack.config.js Revert "chore: optimize CSS imports and PurgeCSS config" 2024-09-04 08:10:41 +02:00

Favicon - moner.ooo

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

  • 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 DataLink 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! Heres 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