https://github.com/migrim/otp-manager-refactored
OTP-Manager is a secure, easy-to-use tool designed to manage one-time passwords (OTP) for various applications.
https://github.com/migrim/otp-manager-refactored
company flask flask-application flask-sqlalchemy management offline-first open-source otp otp-applications otp-generator otp-library otp-verification otpauth password password-manager self-hosted
Last synced: about 1 month ago
JSON representation
OTP-Manager is a secure, easy-to-use tool designed to manage one-time passwords (OTP) for various applications.
- Host: GitHub
- URL: https://github.com/migrim/otp-manager-refactored
- Owner: Migrim
- License: other
- Created: 2024-03-25T17:55:47.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-15T11:12:26.000Z (about 2 months ago)
- Last Synced: 2025-08-31T07:24:17.385Z (about 1 month ago)
- Topics: company, flask, flask-application, flask-sqlalchemy, management, offline-first, open-source, otp, otp-applications, otp-generator, otp-library, otp-verification, otpauth, password, password-manager, self-hosted
- Language: HTML
- Homepage: https://one-auth.net/otp-manager
- Size: 214 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OTP-Manager
OTP-Manager is a secure, easy-to-use tool designed to manage one-time passwords (OTP) for various applications.
It supports **TOTP** (Time-based One-Time Password) and integrates seamlessly with various authentication systems.
The app is completely offline and stores data locally in an SQLite database.
> ℹ️ **Note:** In **version 2.1.0**, a new feature will be introduced to **customize the server port** and other advanced configuration options.
---
## ✨ Features
- **TOTP support** with configurable refresh times
- **Company grouping** for OTP entries (companies can act like folders)
- **Pinned OTPs** for quick access
- **Customizable UI settings** per user (colors, display options, timers)
- **Built-in logger** with daily log files viewable in the admin panel
- **Multiple companies** with a configurable number of OTP secrets (test DB generator included)
- **Advanced search bar** available on **all pages** to instantly search for:
- Companies
- Stored secrets (by name or email)
- **Offline-first** — no internet required
---
## 📦 Installation
### Prerequisites
- Python **3.6+**
- Flask
### Steps
1. Clone the repository:
```bash
git clone https://github.com/Migrim/OTP-Manager.git
```
2. Navigate to the project directory:
```bash
cd OTP-Manager
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```
5. Run the application:
```bash
python app.py
```
---
## ⚙️ Configuration
The default database is stored at:
instance/otp.db
Default **admin credentials**:
- **Username:** `admin`
- **Password:** `1234`
> ⚠️ Change the admin password immediately after first login.
---
## Screenshots
## 🚀 Usage
1. Open your browser and go to:
```
http://localhost:7440
```
2. Log in with your credentials.
3. To **add a company**:
- Go to `Management > Company Settings`
- Enter company details (name, Kundennummer, optional password)
4. To **add an OTP**:
- Click `Add`
- Fill in name, secret, email (optional), refresh time, and company
5. **Search anywhere**:
- Use the **advanced search bar** at the top of every page
- Search by **company name**, **secret name**, or **email**
- Results appear instantly with matching entries
6. **Pin** frequently used OTPs for quick access
7. Admins can view **logs** at `/logs`