Skip to content

FAQ

Jump to bottom
Nathan Grilliot edited this page Feb 10, 2026 · 2 revisions

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 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 for step-by-step instructions
  2. Review the Installation Guide for setup help
  3. See Usage Guide for development workflow
  4. Check the API Data Sources 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

Clone this wiki locally