## Pin Archiver Bot

### What is the Pin Archiver bot and what does it do?

Pin Archiver is a robust Discord pin bot. It automatically saves pinned messages into a designated "pin board", or archive channel. The saved messages are sent in a neat embed and can be sent through the bot or a webhook.

<img src="https://raw.githubusercontent.com/PinArchiver/pinarchiver.github.io/master/assets/Example.png">
<img src="https://raw.githubusercontent.com/PinArchiver/pinarchiver.github.io/master/assets/Example2.png">


### Invite

[Click here to invite Pin Archiver to your server!](https://pinarchiver.xyz/invite)

### Setting up the bot

1. Create an archive channel. Typically you want to disable users' Send Messages permission.
2. *Optional:* Create a webhook in this channel by going to Edit Channel > Integrations > Webhooks > New Webhook. Give it a nice name and profile picture.
3. Use the `.pin setarchive` command to set the channel/webhook as the archive. Example: `.pin setarchive #pins` or `.pin setarchive https://discordapp.com/api/webhooks/123456789/qwertyuiop123456789asdfghjklzxcvbnm` ⚠️Warning: Please be cautious to not publicly share your webhook URL. If someone gets ahold of your webhook URL, they can send unwanted messages through the webhook. Run the command in a secret channel!⚠️
4. Set a pretty color for the archive embeds. Example: `.pin color #be54d1`. Use `.pin color` to send a sample embed to test out the color.
5. Turn on automatic archiving for your desired channels. Example: Go into your #general and run `.pin on`
6. If you don't want the archived messages to be kept in the actual Discord Pinned Messages, use `.pin unpin on`. This is a **server-wide** setting.
7. If you have pinned messages in a channel that you want to archive, run `.pin archive` and it will archive all current pinned messages.

### Commands

Note: Commands can only be performed by users with the Manage Server permission.

- `.pin help` — List commands
- `.pin setarchive [webhook|channel]` — Set what webhook or channel to archive pins to. Archive channel will be set to none if no webhook or channel is given.
- `.pin <on/off>` — Toggle archiving from this channel
- `.pin` — Check if archiving is enabled for this channel
- `.pin unpin <on/off>` — Toggle whether or not the bot unpins a message after archiving it
- `.pin unpin` — Check if automatic unpinning is enabled for this server
- `.pin archive [channel]` — Archive all current pins in channel. The sent command's channel's pins will be archived if no channel is specified.
- `.pin <message id>` — Manually archive a message. This only works if sent in the same channel as the target message.
- `.pin color <hex>` — Set the sidebar color on Pin Archiver embeds in the server
- `.pin color` — Returns the current color and sends a sample embed
- `.pin settings` — See the server's settings

### Support

At the moment, there is no way to contact me for support. I will likely open a Discord server if the bot's userbase expands to the point of necessity. If you experience an issue with the bot, please open an issue at https://github.com/PinArchiver/Issues-and-Suggestions.

### Suggestions and Bug Reports

Is there a problem with the bot? Do you have a feature suggestion? Let me know at https://github.com/PinArchiver/Issues-and-Suggestions. 

### Donations

You may be wondering, "Why is this simple bot asking for donations?" Well, to put it simply, it costs money and time to run a bot smoothly. All donations will be used for hosting costs and development-related investments. Any amount is appreciated!
- BTC Address: 14k6MkKEUPNbDzMckXSkjWtmJXwcm7XV1q
- ETH Address: 0x4c5f2465C417D64658c575e1853972AbBBa5B929
- BCH Address: qzsymv4nf9k7jvyn0glt3vxjmcpgq8mu5szakjh5gd
- XLM Address: GDTDYMMDB362VOG5PNIZT4O3NPA5SXXQJGB5AVZBVF4XFHDFRGLMNZEJ


Pin Archiver

Automatically archive pinned messages in a designated channel. Comes with many settings for the perfect integration in your server.

Voting for Pin Archiver

Do you want to support us?