Documentation Index
Fetch the complete documentation index at: https://mintlify.com/xmistt/rebootpy/llms.txt
Use this file to discover all available pages before exploring further.
DeviceCodeAuth provides a user-friendly authentication method that opens a browser for login without requiring manual code copying.
How It Works
- Bot generates a unique device code
- A browser window opens to Epic Games login page
- You log in through the browser
- Bot automatically detects successful login and completes authentication
Basic Usage
import rebootpy
from rebootpy.ext import commands
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth(
open_link_in_browser=True
)
)
@bot.event
async def event_ready():
print(f'Bot ready as {bot.user.display_name}')
bot.run()
- Your default browser will open automatically
- Log in to your Epic Games account
- The bot will detect the login and connect
Custom Link Handling
If you want to handle the login link yourself (e.g., display it in a GUI), you can use the event_device_code_generated event:
import rebootpy
from rebootpy.ext import commands
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth(
open_link_in_browser=False # Don't auto-open browser
)
)
@bot.event
async def event_device_code_generated(link):
print(f'Please login here: {link}')
# Or display in your GUI, send to Discord, etc.
@bot.event
async def event_ready():
print(f'Bot ready as {bot.user.display_name}')
bot.run()
Parameters
Whether to automatically open the Epic Games login page in the default browser. Set to False if you want to handle the link yourself.
The main Fortnite token to use with authentication. You should generally not need to set this manually.
The switch token to use with authentication. You should generally not need to set this manually.
The token type to use. It’s recommended you only change this if you know what you’re doing.
Attributes
The Authorization header for use with Fortnite endpoints. Use this if you’re making HTTP requests that aren’t already implemented.
The account ID of the authenticated user.
Events
event_device_code_generated
Dispatched when the device code is generated and ready for the user to login.
@bot.event
async def event_device_code_generated(link: str):
"""Called when device code login link is ready.
Parameters
----------
link : str
The URL the user should visit to complete authentication.
"""
print(f'Login at: {link}')
Advanced Usage
Generate Device Auth After Login
You can automatically generate device auth credentials after logging in for easier future logins:
import rebootpy
import json
from rebootpy.ext import commands
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth()
)
@bot.event
async def event_ready():
print(f'Bot ready as {bot.user.display_name}')
# Generate device auth for next time
device_auth = await bot.auth.generate_device_auth()
details = {
'device_id': device_auth['deviceId'],
'account_id': device_auth['accountId'],
'secret': device_auth['secret']
}
with open('device_auths.json', 'w') as fp:
json.dump(details, fp)
print('Device auth saved! Use DeviceAuth next time.')
bot.run()
Custom Login Flow with GUI
import rebootpy
import tkinter as tk
import webbrowser
from rebootpy.ext import commands
class BotGUI:
def __init__(self):
self.root = tk.Tk()
self.root.title('Fortnite Bot')
self.label = tk.Label(self.root, text='Initializing...')
self.label.pack()
self.button = None
self.bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth(
open_link_in_browser=False
)
)
@self.bot.event
async def event_device_code_generated(link):
self.label.config(text='Click button to login')
self.button = tk.Button(
self.root,
text='Login to Epic Games',
command=lambda: webbrowser.open(link)
)
self.button.pack()
@self.bot.event
async def event_ready():
self.label.config(text=f'Connected as {self.bot.user.display_name}')
if self.button:
self.button.destroy()
def run(self):
self.bot.loop.create_task(self.bot.start())
self.root.mainloop()
if __name__ == '__main__':
gui = BotGUI()
gui.run()
Automatic Reauthentication
DeviceCodeAuth supports automatic reauthentication if token refresh fails:
import rebootpy
from rebootpy.ext import commands
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth()
)
@bot.event
async def event_auth_refresh():
print('Authentication tokens refreshed')
@bot.event
async def event_device_code_generated(link):
print(f'Reauthentication required. Please login: {link}')
bot.run()
Common Scenarios
First Time Login
# Best for users who haven't set up device auth yet
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth()
)
Development/Testing
# Quick login for testing without saving credentials
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth()
)
Headless Servers
# For servers without a browser (display link instead)
bot = commands.Bot(
command_prefix='!',
auth=rebootpy.DeviceCodeAuth(
open_link_in_browser=False
)
)
@bot.event
async def event_device_code_generated(link):
print(f'Login URL: {link}')
# Send link via Discord, email, SMS, etc.
Common Errors
Corrective Action Required
If Epic Games requires corrective action (like setting date of birth), the library handles common cases automatically:
# Date of birth is set automatically if required
# No action needed from you
AuthException with details.
Authorization Pending
The bot polls Epic’s servers every 10 seconds while waiting for login. This is normal behavior:
# The bot automatically waits for you to complete login
# No timeout - it will wait indefinitely
Migration Path
For production use, consider migrating to DeviceAuth:
- Use DeviceCodeAuth for initial login
- Generate device auth credentials
- Switch to DeviceAuth for future runs
Or use AdvancedAuth to handle this automatically.