{"id":23550248,"url":"https://github.com/xterna/cryptos-faucets-bot","last_synced_at":"2025-07-25T02:04:08.327Z","repository":{"id":221255359,"uuid":"321199010","full_name":"XternA/cryptos-faucets-bot","owner":"XternA","description":"Automatically claim crypto faucets.","archived":false,"fork":false,"pushed_at":"2024-02-07T11:56:14.000Z","size":47,"stargazers_count":36,"open_issues_count":2,"forks_count":13,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-30T08:51:16.555Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/XternA.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2020-12-14T01:23:01.000Z","updated_at":"2025-03-25T18:49:02.000Z","dependencies_parsed_at":"2024-02-07T01:23:09.992Z","dependency_job_id":"bf14dc1c-fa0c-4b53-9a9a-f88a2e086ba7","html_url":"https://github.com/XternA/cryptos-faucets-bot","commit_stats":null,"previous_names":["xterna/cryptos-faucets-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XternA%2Fcryptos-faucets-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XternA%2Fcryptos-faucets-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XternA%2Fcryptos-faucets-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XternA%2Fcryptos-faucets-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XternA","download_url":"https://codeload.github.com/XternA/cryptos-faucets-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251300047,"owners_count":21567362,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-26T10:15:11.368Z","updated_at":"2025-04-28T10:51:06.593Z","avatar_url":"https://github.com/XternA.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"## About This Project\nA faucet company offering free crypto rolls every hour from Cryptos Faucets. The aim of this script is to automate the rolls and collect the free cryptos.\n\nThis was a project developed for personal use and better left ran unattended. You can run this on your computer or server, wherever you choose to run it.\n\nThe current coins that's claimed is: **BTC  ETH  LTC  BNB  USDT  USDC  TRON  LINK  ADA  DOGE  NEO  DASH  NEM  XRP**\n\nThe bot also is capable of applying promo codes that **[Crypto Faucets](https://twitter.com/cryptosfaucets)** occasically publishes, provided the code hasn't been applied to the account before. This allows the account to gain additional coin claims and reset the wait counter.\n\n## Getting Started\nIn order to run the script, you will require Node.js to be pre-installed first. The script uses a combination of [Node.js](https://nodejs.org/en), [Puppeteer](https://github.com/puppeteer/puppeteer) and [Chromium](https://www.chromium.org).\n\n### Prerequisites\nInstall Node.js: https://nodejs.org/en/download/\n\nOnce installed, using the `Terminal` (Linux/macOS) or `Command Prompt` (Windows), simply execute `npm i` or `npm install` in the directory of this project. Node.js's package manager will then automatically install all the required dependencies from `package.json`.\n\n## Usage\nWith all the pre-requisites setup and completed the rest is pretty straightforward.\n\nA brief note in case you're not familiar with command line or terminal usage. On Windows, you can simply run the `.bat` file or via Command Prompt by typing in the command.\nOn Linux and macOS, you will need to run the `.sh` file via a Terminal.\n\n### 1. Bot Configuration\nYou need to first edit the `config.ini` and supply an email and password. The email and password will be used to sign up and login to claim the rewards across the sites.\n\n#### Credentials\nReplace the section `\u003cemail\u003e` and `\u003cpass\u003e` with your chosen credentials.\n```ini\n[user]\nemail=\u003cemail\u003e\npass=\u003cpass\u003e\n```\nRest assured, I'm not interested in your credentials as this is only used by the bot to run locally to automate a human interaction as you would do so manually.\n\n#### Browser\nThis is not required if the bot works for you. Definately required if you plan to run on a Raspberry Pi.\n\nFor instances where the bot fails to run the bundled Chromium browser, you will need to supply a path to a browser, e.g. running on a Raspberry Pi requires it's own compiled version of the Chromium browser so the path has to be supplied.\n\nTo supply the browser can be done as example syntax:  \n**Note: Your browser path may differ.**\n```ini\n### Windows ###\nbrowserpath=C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe\n\n### Linux ###\nbrowserpath=/usr/bin/chromium-browser\n```\n\n### 2. Signing Up\nYou need to first sign up to the Faucet site with an account before you can start claiming the coins.\n\nTo make life simpler, there is a `signup.sh/.bat` script that will automatically do the registering for you. It will read the configuration file `config.ini` for the credentials you've provided. All you have to do is just execute the script. \n\nOnce the script bot signed up to all the sites, you just need to check your mail box for the email you've used in the `config.ini` and confirm the account creation otherwise the bot won't be able to claim the rewards.\n\n#### Windows\n```console\nsignup.bat\n```\n\n#### Linux | macOS\nMake sure that the script is executable if it isn't.\n```console\nchmod +x signup.sh\nsh signup.sh\n```\n\n### 3. Running the Bot\nRunning the bot is as simple as executing the `shell (Unix)` or `batch (Windows)` script.\n\n#### Windows\n```console\ncrypto-bot.bat\n```\n\n#### Linux | macOS\nMake sure that the script is executable if it isn't.\n```console\nchmod +x crypto-bot.sh\nsh crypto-bot.sh\n```\n\n### 4. Updating\nWhen changes have been pushed out, you can update the bots to the latest from this repository by invoking `git pull` from the main directory. \n\nIn the event that the command failed due to your local changes conflicting, you will need to reset the local changes to default and then pull the latest changes. You can do this with `git reset --hard`. This will revert all changes and you can proceed with pulling the new changes. Note that resetting means you need to re-configure your `config.ini` again.\n\nIf after updating, the bot fails when attempting to run, simply remove the `node_modules` completely and re-install the required modules with `npm i`.\n\nTo remove the node modules from `Terminal` or `Command Prompt`, invoke:\n\n#### Linux | macOS\n```console\nrm -rf node_modules\n```\n\n#### Windows\n```console\nrd /q/s node_modules\n```\n\n### New Faucets Added\nIn addition to updates, there may occasionally be new faucets added. If that's the case, after you've update the bots, you can simply run the `signup.sh/bat` script to register any new faucets that have been added.\n\n## Running Unattended\nBecause it's a script that's ran on console level, you can set the script to run at startup. There are various ways to achieve this.\n\n### Windows\nYou can use Windows' built-in Task Scheduler to make the script run at startup. You can find out how to do that **[here](https://www.thewindowsclub.com/run-batch-files-silently-on-windows)**.\n\n### Linux | macOS\nOn UNIX type systems you could use a combination of **[crontab](https://help.dreamhost.com/hc/en-us/articles/215767047-Creating-a-custom-Cron-Job)** and **[screen](https://linuxize.com/post/how-to-use-linux-screen/)** to create a cron job to run on startup. You can choose not to use `screen` if you like.\n\n\n## Support \u0026 Donations\nIf you choose to register the sites manually instead and or to support the project, kindly register with my referral links. You can also share the links and the bot with others.\n\n**I also accept donations:**  \n- **BTC:** bc1qq993w3mxsf5aph5c362wjv3zaegk37tcvw7rl4\n- **ETH:** 0x2601B9940F9594810DEDC44015491f0f9D6Dd1cA\n- **PayPal:** [@xterna](@xterna)\n\n#### Referrals to Faucet\n[![BTC](https://freebitcoin.io/img/freebitcoin/banners/Banner468x60.jpg)](https://freebitcoin.io/?ref=366602)  \n**BTC- https://freebitcoin.io/?ref=366602**\n\n[![ETH](https://freeethereum.com/img/freeethereum/banners/Banner468x60.jpg)](https://freeethereum.com/?ref=96650)  \n**ETH - https://freeethereum.com/?ref=96650**\n\n[![LTC](https://free-ltc.com/img/freelitecoin/banners/Banner468x60.jpg)](https://free-ltc.com/?ref=27952)  \n**LTC - https://free-ltc.com/?ref=27952**  \n\n[![USDT](https://freetether.com/img/freetether/banners/Banner468x60.jpg)](https://freetether.com/?ref=114067)  \n**USDT - https://freetether.com/?ref=114067**  \n\n[![USDC](https://freeusdcoin.com/img/freeusdcoin/banners/Banner468x60.jpg)](https://freeusdcoin.com/?ref=75332)  \n**USDC - https://freeusdcoin.com/?ref=75332**  \n\n[![BNB](https://freebinancecoin.com/img/freebinancecoin/banners/Banner468x60.jpg)](https://freebinancecoin.com/?ref=72163)  \n**BNB - https://freebinancecoin.com/?ref=72163**  \n\n[![LINK](https://freechainlink.io/img/freechain/banners/Banner468x60.jpg)](https://freechainlink.io/?ref=34381)  \n**LINK - https://freechainlink.io/?ref=34381**  \n\n[![NEO](https://freeneo.io/img/freeneo/banners/Banner468x60.jpg)](https://freeneo.io/?ref=39047)  \n**NEO - https://freeneo.io/?ref=39047**  \n\n[![ADA](https://freecardano.com/img/freecardano/banners/Banner468x60.jpg)](https://freecardano.com/?ref=249042)  \n**ADA - https://freecardano.com/?ref=249042**  \n\n[![DOGE](https://free-doge.com/img/freedoge/banners/Banner468x60.jpg)](https://free-doge.com/?ref=14646)  \n**DOGE - https://freecardano.com/?ref=249042**  \n\n[![TRON](https://free-tron.com/img/freetron/banners/Banner468x60.jpg)](https://free-tron.com/?ref=100636)  \n**TRON - https://free-tron.com/?ref=100636**  \n\n[![DASH](https://freedash.io/img/freedash/banners/Banner468x60.jpg)](https://freedash.io/?ref=54242)  \n**DASH - https://freedash.io/?ref=54242**  \n\n[![XRP](https://coinfaucet.io/img/coinfaucet/banners/Banner468x60.jpg)](https://coinfaucet.io/?ref=698164)  \n**XRP - https://coinfaucet.io/?ref=698164**  \n\n[![NEO](https://freenem.com/img/freenem/banners/Banner468x60.jpg)](https://freenem.com/?ref=251426)  \n**NEM - https://freenem.com/?ref=251426**  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxterna%2Fcryptos-faucets-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxterna%2Fcryptos-faucets-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxterna%2Fcryptos-faucets-bot/lists"}