https://github.com/13m0n4de/purrify
HashCat mask generator for mobile phone numbers based on libphonenumber metadata
https://github.com/13m0n4de/purrify
brute-force dictionary-attack hashcat libphonenumber security wordlist wordlist-generator
Last synced: about 2 months ago
JSON representation
HashCat mask generator for mobile phone numbers based on libphonenumber metadata
- Host: GitHub
- URL: https://github.com/13m0n4de/purrify
- Owner: 13m0n4de
- License: mit
- Created: 2025-10-23T14:24:08.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-11-01T20:31:20.000Z (9 months ago)
- Last Synced: 2025-11-01T21:14:53.011Z (9 months ago)
- Topics: brute-force, dictionary-attack, hashcat, libphonenumber, security, wordlist, wordlist-generator
- Language: Python
- Homepage:
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Purrify
[English](README.md) | [中文](README.zh.md)
[HashCat](https://github.com/hashcat/hashcat) mask generator for mobile phone numbers based on libphonenumber metadata, inspired by [Felinize](https://github.com/Arnie97/felinize/).
Creates `.hcmask` files with all mobile phone numbers in specified cities, according to the [`ranges.csv` metadata provided by libphonenumber][1].
## Installation
Download phone number ranges provided by [libphonenumber](https://github.com/google/libphonenumber):
```
curl -#LO https://github.com/google/libphonenumber/raw/master/metadata/metadata.zip
unzip -j metadata.zip metadata/86/ranges.csv
```
> **Note:** The `86` in the path represents China's country calling code. You can replace it with other country codes as needed (e.g., `1` for USA/Canada, `44` for UK, `81` for Japan, etc.).
Install Purrify using [uv](https://github.com/astral-sh/uv):
```
uv tool install git+https://github.com/13m0n4de/purrify
```
## Usage
Specify one or more city names in Chinese, English, or other languages:
```
purrify 南京 shanghai < ranges.csv > phones.hcmask
hashcat -a 3 -m 13000 rar.hash phones.hcmask
```
If you need a wordlist file, you can generate one from the `.hcmask` file using hashcat:
```
hashcat -a 3 --stdout phones.hcmask > phones.list
```
[1]: https://github.com/google/libphonenumber/blob/master/metadata/metadata.zip