|
| 1 | +# Isekai Chrome Extension |
| 2 | + |
| 3 | +[](https://github.com/isekai-sh/isekai-chrome-extension/releases/latest) |
| 4 | +[](https://github.com/isekai-sh/isekai-chrome-extension/blob/main/LICENSE) |
| 5 | +[](https://github.com/isekai-sh/isekai-chrome-extension/actions) |
| 6 | +[](https://isekai.sh/chrome-extension) |
| 7 | + |
| 8 | +Browser extension to help artists manage DeviantArt exclusive sales efficiently. Works seamlessly with your [Isekai](https://isekai.sh) deployment. |
| 9 | + |
| 10 | +## Purpose |
| 11 | + |
| 12 | +DeviantArt's official API does not provide programmatic access to exclusive sales management. This extension bridges that gap for professional artists managing large portfolios. It operates respectfully - opening each page once, processing the form, and closing immediately, ensuring no unnecessary load on DeviantArt's servers. |
| 13 | + |
| 14 | +## Features |
| 15 | + |
| 16 | +- **Sales Management Assistant**: Helps you process exclusive sales from your organized queue |
| 17 | +- **Your Account**: Uses your actual DeviantArt login - you remain in control at all times |
| 18 | +- **Non-Intrusive**: Handles form filling in background tabs while you continue your work |
| 19 | +- **Activity Logs**: Detailed logging of all sales operations for business record-keeping |
| 20 | +- **Lightweight**: Just ~500KB browser extension, no additional software needed |
| 21 | +- **Secure**: Operates entirely in your browser using API key authentication |
| 22 | + |
| 23 | +## Documentation |
| 24 | + |
| 25 | +Complete documentation is available at [isekai.sh/chrome-extension](https://isekai.sh/chrome-extension): |
| 26 | + |
| 27 | +- [Installation Guide](https://isekai.sh/chrome-extension/installation) - Install on Windows, macOS, or Linux |
| 28 | +- [Configuration](https://isekai.sh/chrome-extension/configuration) - Set up API URL and API key |
| 29 | +- [Usage Guide](https://isekai.sh/chrome-extension/usage) - Learn how to use the popup and console |
| 30 | +- [Troubleshooting](https://isekai.sh/chrome-extension/troubleshooting) - Common issues and solutions |
| 31 | + |
| 32 | +## Quick Start |
| 33 | + |
| 34 | +1. Download the latest release from [GitHub Releases](https://github.com/isekai-sh/isekai-chrome-extension/releases/latest) |
| 35 | +2. Extract the ZIP file to a permanent location |
| 36 | +3. Open `chrome://extensions/` in your browser |
| 37 | +4. Enable "Developer mode" (top-right toggle) |
| 38 | +5. Click "Load unpacked" and select the extracted folder |
| 39 | +6. Configure your API URL and API key in the extension settings |
| 40 | +7. Click Start to begin processing jobs |
| 41 | + |
| 42 | +For detailed instructions, see the [Installation Guide](https://isekai.sh/chrome-extension/installation). |
| 43 | + |
| 44 | +## Requirements |
| 45 | + |
| 46 | +- Chrome, Edge, Brave, or any Chromium-based browser |
| 47 | +- Running [Isekai Core](https://github.com/isekai-sh/isekai-core) deployment |
| 48 | +- DeviantArt account (must be logged in) |
| 49 | +- API key from your Isekai instance |
| 50 | + |
| 51 | +## Development |
| 52 | + |
| 53 | +```bash |
| 54 | +# Install dependencies |
| 55 | +pnpm install |
| 56 | + |
| 57 | +# Development mode with hot reload |
| 58 | +pnpm dev |
| 59 | + |
| 60 | +# Build for production |
| 61 | +pnpm build |
| 62 | + |
| 63 | +# Type check |
| 64 | +pnpm type-check |
| 65 | +``` |
| 66 | + |
| 67 | +## Architecture |
| 68 | + |
| 69 | +- **Service Worker**: Background script that polls the backend API for pending jobs |
| 70 | +- **Content Script**: Injects into DeviantArt pages to perform DOM automation |
| 71 | +- **Popup**: Compact toolbar widget for quick status and controls |
| 72 | +- **Console**: Full-featured terminal interface for logs and job history |
| 73 | + |
| 74 | +Built with TypeScript, Vite, and Chrome Extension Manifest V3. |
| 75 | + |
| 76 | +## Support |
| 77 | + |
| 78 | +- Documentation: [isekai.sh/chrome-extension](https://isekai.sh/chrome-extension) |
| 79 | +- Report Issues: [GitHub Issues](https://github.com/isekai-sh/isekai-chrome-extension/issues) |
| 80 | +- Main Project: [Isekai Core](https://github.com/isekai-sh/isekai-core) |
| 81 | + |
| 82 | +## License |
| 83 | + |
| 84 | +MIT - See [LICENSE](./LICENSE) file for details. |
0 commit comments