Expressive phrase generator — strong, modern, and minimalist.
Built entirely in Python for CLI environments on Linux and Windows.
XPhrase Generation is a multilingual phrase generator designed for command-line interface (CLI) usage.
It creates expressive, randomized phrases using words from Portuguese, English, and German, interlinked with special characters and digits.
This project is:
- 💯 Written 100% in Python
- 🖥️ CLI-compatible for Linux and Windows
- 🌐 Future-ready for HTML interface integration
- Generates phrases with 3 to 21 words
- Words are randomly selected from Portuguese, English, and German word banks
- Each word is interlinked with:
- At least one special character:
!@#$%^&*()_+-=[]{}|;:,.<>?~\\ - At least one digit:
0123456789
- At least one special character:
- The last character of the final word is always uppercase
- Output example:
ice8café*intentos7vermeideN
- Python 3.8+
- No external dependencies
- Works on:
- ✅ Linux (Debian, Ubuntu, Arch, etc.)
- ✅ Windows (PowerShell, CMD)
Do not attempt to memorize the passwords generated by this tool. Instead, use a reliable password manager, such as Bitwarden©, which I personally recommend. The only password you should memorize is the master password for your password manager's vault, created with a strong combination of uppercase and lowercase letters, numbers, and special characters. Enable two-factor authentication (2FA) whenever possible to enhance security. A great option for managing your 2FA is Ente Auth , a free, open-source, and cross-platform app that provides end-to-end encrypted backups. Ente Auth ensures your 2FA codes are secure and synced across devices, with externally audited encryption, offering robust protection for all your accounts that support 2FA.
- No additional dependencies are required, as the project uses only Python standard libraries.
- Ensure you have Python 3.8 or higher installed.
- Clone the repository:
git clone https://github.com/gerivanc/xphrase.git
cd xphrase
Generates 1 sentence (interactive mode):
python xphrase.py
Generates 5 sentences:
python xphrase.py --count 5
Sentences with 5-10 words:
python xphrase.py --min 5 --max 10
Show version:
python xphrase.py --version
Explicit interactive mode:
python xphrase.py --interactive
Simple generation:
python xphrase.py --count 3
Longer sentences:
python xphrase.py --min 10 --max 15 --count 2
- Phrase length: 3 to 21 words
- Each word must include:
- 1+ special character
- 1+ digit
- Final word must end with a capital letter
- Language order is randomized
python xphrase.py --min 2 --max 2
Generated phrase:
mainlymaintainmaintenancemajormajoritymakemakermakeupmalemallmanmanage,2pensãO
python xphrase.py --count 1
Generated phrase:
investinvestigateinvestigationinvestigatorinvestmentinvestorinviteinvolveinvolvedinvolvementIraqiIrish^0themthemethemselvesthentheorytherapytherethereforethesetheythickthinthing{9benfazejo_6depender%5Lauf%4employeeemployeremploymentemptyenableencounterencourageendenemyenergyenforcementengage*1Schaf*3petphasephenomenonphilosophyphonephotophotographphotographerphotographyphysicalphysicallyphysician.1turbO
xphrase/
├── .github/
│ └── ISSUE_TEMPLATE
│ ├── bug_report.md
│ ├── config.yml
│ └── issue_template.md
│ └── workflows/
│ ├── pypi-publish.yml
│ └── python-app.yml
│
├── data/
│ ├── __init__.py
│ ├── english_words.py
│ ├── german_words.py
│ └── portuguese_words.py
│
├── docs/
│ ├── .nojekyll
│ ├── CNAME
│ ├── _config.yml
│ └── index.html
├── tests/
│ ├── __init__.py
│ └── test_xphrase.py
│
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── SECURITY.md
├── pyproject.toml
├── requirements.txt
├── setup.py
├── word_manager.py
└── xphrase.py
- It contains 4,000 specific and unique words, selected from the vocabulary of three different languages.
- This project was created by selecting words to generate sentences in three languages: English, Portuguese, and German.
- All words are stored in separate
.txtfiles inside thedata/folder. - Words are randomly selected and mixed across languages.
| Language | Word Count |
|---|---|
| English | 1,334 |
| Portuguese | 1,333 |
| German | 1,333 |
- 🌐 HTML interface (web version)
- 📦 Packaging for PyPI
- 🧪 Unit tests and coverage
Contributions are welcome! Please follow the guidelines in CONTRIBUTING.md.
See the RELEASE.md for detailed release notes for each version.
Help us improve XPhrase Generation by reporting bugs or suggesting enhancements to project. To report a bug, suggest a feature, or ask a question:
-
Go to the Issues tab.
-
Click New issue.
-
View the available options and select to: Report Bug and/or Report Issue. For security vulnerabilities, please follow our Security Policy.
If you encounter a bug in the XPhrase Generation, please report it using our dedicated Bug Report template. This template ensures that your report includes essential details, such as steps to reproduce, environment information, and logs, enabling us to address issues efficiently. For other types of contributions or inquiries, refer to our CONTRIBUTING.md.
For security vulnerabilities, follow the process in SECURITY.md instead of opening a public issue. We recommend using a password manager and enabling 2FA for enhanced security.
See the CHANGELOG.md for a detailed history of changes to this project.
This repository is licensed under the MIT License.
E-mail: [email protected]
Location: Brazil
Feel free to reach out for collaboration or feedback!