A Node.js package that turns a Samsung model number into a human readable device name, and returns categorized lists of phones, tablets and watches. It was my first open source project and it is still the one people install most often.

Features

• getNameByModel(model) resolves a model number to a device name
• getAllSamsungPhones(), getAllSamsungTablets() and getAllSamsungWatches() return full lists
• getAllSamsungDevices() returns everything across categories
• Phone catalogue covers models released from 2017 onwards
• Subpath imports so you only bundle the category you need

Install

npm install samsung-device-helper

Keeping the catalogue current

The catalogue is maintained by a companion AI agent that uses Playwright MCP and Claude. It reads the current year's device file from GitHub, scrapes GSM Arena for new releases, sorts them by release date, and opens a pull request automatically whenever the catalogue has fallen behind.

Links

Source on GitHub, package on npm.