Celes is an Open Source file and registry scraper that obtains and stores game achievements, whatever the origin.
Celes is a Typescript library that allows other tools to scrap files and registries to obtain user achievements from multiple sources. It includes multiples functionalities like detecting games, loading schemas and generating a list of unlocked achievements, together with import and export features. It also has a built-in database, which allows it to store local caches than can also be used by other tools.
Initially part of the Achievement Watcher project, now it has been released as an independent tool due to the organization being closed. The repository is going to be keep as an Open Source archive to facilitate and guide future developments in the same field.
To see the list of compatible sources and platforms, refer to COMPATIBILITY.
You need NPM to install Celes. If you don't have it, you can download it at https://www.npmjs.com/.
Celes is available at NPM, so you can install it directly from there:
npm install --save @achievement-watcher/celes
import {Celes} from '@achievement-watcher/celes'Celes is the main class exported and the one that has to be used in the majority of cases. If can be widely configured as presented below:
class Celes {
constructor(
achievementWatcherRootPath: string,
additionalFoldersToScan?: string[],
enabledPlugins?: string[],
steamPluginMode?: 0 | 1 | 2,
systemLanguage?: string,
useOldestUnlockTime?: boolean
) {}
}- achievementWatcherRootPath: string: Root path of the data folder of the Achievement Watcher project. It should
be created in the installation of Achievement Watcher and, usually, it defaults to
%APPDATA%/Achievement Watcher. Inside of it, caches and schemas and user stats are stored. - additionalFoldersToScan?: string[]: List of folders defined by the user to scan. Used by some plugins to try to scrap achievement data from there.
- enabledPlugins?: string[]: List of plugin names that have to be used. The plugin names are defined by the name of the files stored under (src/lib/plugins)[src/lib/plugins]. By default, all of them are enabled.
- steamPluginMode?: 0 | 1 | 2: Work mode of the Steam plugin:
- 0 -> Disabled.
- 1 -> Enabled. Only Installed games are shown.
- 2 -> Enabled. All games are shown.
- systemLanguage?: string: User defined language. Defaults to english.
- useOldestUnlockTime?: boolean: Method to be used when merging same achievements from different sources. By default, oldest unlock time is used, which means that, under collision, the unlock time stored is the most ancient one.
This is the list of public methods available at Celes. An always-updated explanation can be found inside of the src/lib/Celes.ts file. In the case of the NPM package, the detailed explanation should be instead at dist/lib/Celes.d.ts.
async pull(callbackProgress?: (progress: number) => void): Promise<ScrapResult> {};
async load(callbackProgress?: (progress: number) => void): Promise<GameData[]> {};
async export(filePath: string): Promise<void> {};
async import(filePath: string, force?: boolean): Promise<GameData[]> {};
async addGame(appId: string, platform: Platform): Promise<void> {};
async removeManuallAddedGame(appId: string, platform: Platform): Promise<void> {};
async unlockAchievement(appId: string, platform: Platform, achievementId: string, unlockTime = 0): Promise<void> {};
async removeManuallyUnlockedAchievement(appId: string, platform: Platform, achievementId: string): Promise<void> {};
async setAchievementUnlockTime(appId: string, source: Source, platform: Platform, achievementId: string,
unlockTime: number): Promise<void> {};
async addGamePlaytime(appId: string, platform: Platform, playtime: number,
force?: boolean): Promise<void> {};
Contributions are welcome. See CONTRIBUTING for more information.
Distributed under the GPL-3.0 License. See LICENSE for more information.
Celes is a technology able to connect and scrap achievements from both legal and non-legal sources. These sources, in the second cases, are related to games installed locally using cracks, emulators or any other technologies that may be related to cases of intellectual property being robbed or damaged. In any case, while this is a technical possibility, we do not enforce or support these practises and do not want to be associated with them.
As a matter of fact, any issue related to piracy is going to be removed and no support is going to be given in relation to obtaining games or roms from non-legal sources. Following this, any user is responsible of the content placed in its own issues, commentaries, code, pull requests or other additions.
Finally, in relation to the Achievement Watcher project. This component has been separated from it and there is no association between both. Any legal issue related to this project should not be reflected there and vice verse.