ArtStation Portfolio Organizer

WHAT IT DOES

This userscript helps artists and designers organize their ArtStation portfolio by providing an interactive management interface. It scans portfolio and project pages to extract project thumbnails, titles, categories, and dates. You can then reorder projects (drag to custom order), filter by category or tag, add visual tags or labels to projects, and toggle between grid and list views. The script persists your custom organization—tags, order, view mode—locally in your browser, so your portfolio stays organized across sessions. You can also bulk-select projects for moving between groups, and use the search bar to quickly find projects by title or tag.

WHERE IT RUNS

The script works on ArtStation portfolio pages and project gallery views. It runs entirely within your browser, reading only the visible content of the current page. It does not track your browsing history, access other tabs, or send any data externally. All organization data—tags, custom order, view preferences—is stored locally in your browser using GM_setValue.

HOW TO USE

After installation, open the panel by clicking the tool's icon in the BotGentz sidebar. Choose your default view mode—grid or list. Select your preferred sort order—by date, by title, or custom order (drag to reorder). Toggle "Auto-scan on page load" to automatically organize portfolios when you visit a page. Click "Scan and organize" to extract projects and apply your current settings. The panel will display your projects in the selected view with tags and sorting applied. Use "Clear organization" to remove all custom tags and restore the default view.

THE TECHNICAL MECHANISM

This script uses DOM traversal and pattern matching to extract project data from ArtStation pages. It scans for project elements using common ArtStation selectors like .project-card, .project-item, and [data-project-id]. For each element, it extracts the project title, category, date, and thumbnail image URL. The script then applies the user's saved state—tags, custom order, view mode, and sort preference—to the extracted projects. Tags are stored as arrays in a JSON object keyed by project ID. Custom order is stored as an array of project IDs. The projects are sorted accordingly, and the view mode (grid or list) is applied via CSS grid or flexbox. All organization data is stored using GM_setValue and loaded on each scan, ensuring persistence across sessions. The script avoids innerHTML for security, using DOM methods to build the interface.

THE PANEL

The panel is draggable anywhere on the screen and remembers its position between sessions. It can be collapsed to a small floating bubble to minimize distraction, and expanded again with a single click. The panel's width can be adjusted, and pressing the Escape key closes it instantly. All settings—view mode, sort order, and auto-scan—are persisted locally using GM_setValue, so your preferences remain intact across page reloads and browser restarts.

PLEASE NOTE

This userscript requires the free BotGentz extension to function. The script is designed for ArtStation; it may work on other portfolio sites with similar structures but is not guaranteed. The project extraction relies on the current HTML structure of ArtStation—if ArtStation updates their UI, the script may need to be updated. The script does not access your ArtStation account or API; it only reads what is visible on the page. Tags and organization data are stored only in your browser and are not shared or transmitted anywhere. No data from your browsing is stored or transmitted—all processing occurs entirely in your browser.