No description
Find a file
rottenwheel 3ade0bffce
Merge pull request #1 from recanman/main
Add cache, API key support, refactor code
2024-09-10 06:03:24 +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 feat: improve cache, refactor code, add api key support 2024-09-09 22:54:33 -07:00
coingecko.php feat: improve cache, refactor code, add api key support 2024-09-09 22:54:33 -07: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 feat: improve cache, refactor code, add api key support 2024-09-09 22:54:33 -07:00
secrets.dist.php feat: improve cache, refactor code, add api key support 2024-09-09 22:54:33 -07: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']
    ],
];

Create a secrets.php file in the root directory to store CoinGecko API keys. Example:

<?php
return [
	'coingecko_api_key' => 'CG-xxxx',
	'coingecko_key_is_demo' => true,
];

Note: The secrets.dist.php file should not be accessible from the web server.

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