# Frequently Asked Questions (FAQ)

This page answers common questions about NQ installation, setup, usage, and troubleshooting.

## General Questions

### What is NQ?

NQ (Next in Queue) is a smart media recommendation system that helps you decide what to watch, play, read, or listen to next. It connects to your accounts to understand your preferences and suggest content you'll enjoy.

### Who is NQ for?

NQ is designed for anyone who:
- Has trouble deciding what to watch, play, or read next
- Uses multiple streaming and media services
- Wants personalized recommendations based on their actual preferences
- Enjoys discovering new content similar to what they already like

### What platforms does NQ support?

NQ currently supports:
- iOS
- Android

### Is NQ free to use?

Yes, NQ is free and open source under the MIT license.

## Installation Questions

### What do I need to install before hosting NQ?

You need three main things:
1. **Go** (version 1.25.1 or newer) - For running the backend server
2. **Node.js** (version 18 or newer) - For running the mobile app
3. **Neo4j** database - Either a free cloud instance or local installation

See the [Installation Guide](Installation.md) for detailed setup instructions.

### I don't want to connect all services. Can I use just a few?

Absolutely! NQ works with any combination of services. Start with just one or two that you use most, and add more later if you want.

## Usage Questions

### How do I start using NQ after installation?

1. Start the backend server (in the `backend` folder, run `go run .`)
2. Start the mobile app (in the `nq-frontend` folder, run `npx expo start`)
3. Open the app on your phone or emulator
4. Connect your media accounts through the app

### How does NQ make recommendations?

NQ builds a graph of your media consumption:
1. It syncs your activity from connected services (what you've watched, played, listened to)
2. It enriches this data with metadata (genres, creators, themes, etc.)
3. It analyzes relationships between media items in the graph database
4. It calculates "fitness scores" for potential recommendations based on your preferences

## Development Questions

### Can I contribute to NQ?

Yes! NQ is open source. Check out the repository and feel free to submit issues or pull requests.

## Getting More Help

### Where can I get help if my question isn't answered here?

1. Check the [User Guide](User-Guide.md) for step-by-step instructions
2. Review the [Installation Guide](Installation.md) for setup help
3. See [Usage Guide](Usage.md) for development workflow
4. Check the [API Data Sources](API-Data-Sources.md) for API-specific issues
5. Submit an issue on the GitHub repository

### How do I report a bug?

Submit a GitHub issue with:
- Description of the problem
- Steps to reproduce
- Expected vs actual behavior
- Error messages (if any)
- Your environment (OS, Go version, Node version)

### How do I request a feature?

Submit a GitHub issue describing:
- What you'd like to add or change
- Why it would be useful
- How you envision it working