Language:
switch to room list switch to menu My folders
Go to page: 1 2 [3]
[#] Fri Dec 27 2013 16:24:40 EST from TaMeR @ Uncensored

Subject: Re: [ANN] CitadelSync a vcard uploader for citadel

[Reply] [ReplyQuoted] [Headers] [Print]

I updated the docs on the website.

Yes it is written in Go.

No this is an application not a lib. but it uses a lib, to access Citadel.

That lib. is also available opensource MIT License here:

https://bitbucket.org/gotamer/citadel

 

 

 


Imports vCards in to the Citadel Mail Server


Features

  • Citadel Sync will work on most operating systems including Linux, Mac, PC, Android ...
  • Converts a multi vCard file in to many for each to hold a single contact
  • Adds UID and REV fields to the vCard if missing
  • Uploads vCards to a given remote Citadel Mail Server
  • You can specify, which folder on the server to upload to
  • Can populate the Display name field from first and last name, or populate first and last name from display name

Features planned

  • Compare revision state and sync in case you modify a vCard on the server. This is not supported in version 1, vCards on the server will be over written by the local once.
  • Create an executable for Android etc.
  • Create a single vCard to hold all contacts, so it can be used as an address book in Thunderbird etc.

Features not supported

  • Does not support non standard vCard fields like (If you must have one or two of those let me know)
    • X-EVOLUTION-RADIO
    • X-KADDRESSBOOK-X-AssistantsName

Hints:

  • Backup your vCards before you start using citadelsync, both local and server
  • Backup your config file before you upgrade to a new version of citadelsync

Command Line Flags:

A config file is required, set it with the -c flag.

If the specified config file does not exist, one will be created with default values.

-D will delete all items on the remote server, in the given room WITHOUT WARNING

Username and Password for the Citadel Mail Server may be defined in the config file, or optionally on the command line

The -r Flag checks if the room exists on the mail server. You can use this to verify that you have spelled the room name correctly

-v=false: version -h=false: Prints out this help text -c="citadelVcard.json": Config file (*.json) -u="": Username -p="": Password -r=false: Check if the citadel room even exists -D=false: Delete all items in the room! -i="": Import file (*.vcf) 

The Environment flags in the config file are:

0 = Production 1 = Prints a lot of info 2 = Debug mode, same as 1 but will exit on error 

Install

Executable

There is an executable version for Linux AMD64 at:https://bitbucket.org/gotamer/citadel/downloads/citadelsync

From Source

Install go then run

go get bitbucket.org/gotamer/citadel 

The MIT License (MIT)

Copyright © 2013 Dennis T Kaplan http://www.robotamer.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub-license, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

 

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.



[#] Sat Dec 28 2013 08:59:08 EST from dothebart @ Uncensored

Subject: Re: [ANN] CitadelSync a vcard uploader for citadel

[Reply] [ReplyQuoted] [Headers] [Print]

[#] Sun Dec 29 2013 21:45:27 EST from TaMeR @ Uncensored

Subject: ANN Citadel Sync Version 2 released

[Reply] [ReplyQuoted] [Headers] [Print]

 

Citadel Sync


Upload to a Citadel Mail Server


Citadel Sync can upload files to a specified room on a remote Citadel Mail Server.

You may upload any type of text files but Citadel Sync is most useful for

  • Contacts from vCards .vcf
  • Notes from vNotes .vnt
  • Calendar from vCalendars .vcs or .ics
  • Task from vCalendars .vcs or .ics
  • Text from any text based files .txt

HowTo

cd
mkdir citsync
cd citsync
wget https://bitbucket.org/gotamer/citadelsync/downloads/citadelsync
citadelsync -n contacts
nano contacts.cfg.json

The above download link is compatible with any Linux AMD64 based system For other systems please see install section below

{
    "Version": 2,
    "Environment": 1,
    "LocalDir": "/home/username/pim/contacts",
    "Room": "Contacts",
    "Username": "TaMeR",
    "Password": "God knows what",
    "Server": "localhost",
    "Port": ":504",
    "Floor": "Not implemented",
    "SSL_KEY": "Not implemented",
    "SSL_CER": "Not implemented"
}

Version:

Do not change unless prompted after an upgrade.

Environment:

1. Production
2. Info mode, prints a lot of info in to the log file
3. Debug mode, will print to screen, and exit if it finds something not quite right

LocalDir:

Point to the local folder containing your vCards, vNotes etc. files

Room:

The Citadel Room to upload to

Username and Password

Your Citadel username or password. Keep empty "" to specify on the command line

Server:

Your Citadel hostname.

Port:

Your Citadel port. Standard is 504 if you haven't changed it on the server.


When you are done editing run again

citadelsync -n contacts

This will

  1. Check your server connection
  2. Your login information
  3. The availability of the room
  4. The compatibillity of the room with your file type
  5. Your LocalDir

If everything checks out it will upload all files from your LocalDir to the specified Room on the remote Citadel Server.


Notes

  • Files must be individual files each holding a single entry residing in one folder, anywhere on your computer or device.

  • Citadel Sync remembers the state of your files and will only upload modified files

  • Citadel Sync will not delete or modify any files it didn't upload, unless you use the -D flag.

Install

Executable

There is an executable version for Linux AMD64 at:

https://bitbucket.org/gotamer/citadelsync/downloads/citadelsync

From Source

Install go then run

go get bitbucket.org/gotamer/citadelsync

 


-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync



[#] Mon Dec 30 2013 06:42:01 EST from dothebart @ Uncensored

Subject: Re: ANN Citadel Sync Version 2 released

[Reply] [ReplyQuoted] [Headers] [Print]

Hint:

yaml.org for config files.

  - human readable & writeable (more than json)

  - can do comments (json can't)

  - can do here documents (i.e. documentation in markdown)

 

similar to json, there are dumpers & Readers available; having a sample config structure inside of the program, and dumping it using the yaml dumper is a good thing to do.

 

Btw, Plain text - do you do quoted printeable encoding? since email is 8 bit, and you mustn't have umlauts etc. in mails.



[#] Sat Jan 18 2014 12:51:12 EST from TaMeR @ Uncensored

Subject: Re: ANN Citadel Sync Version 2 released

[Reply] [ReplyQuoted] [Headers] [Print]

 

Go works with UTF-8

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync



[#] Sat Jan 18 2014 12:59:43 EST from TaMeR @ Uncensored

Subject: [ANN] Citadel PHP

[Reply] [ReplyQuoted] [Headers] [Print]

Citadel PHP

Citadel is a email and collaboration server.

There is also a web server for Citadel called Webcit.
However, I use Webcit almost exclusively for Admin/Aida purposes.

My users use either a desktop client or Roundcube, which is a PHP driven web mail client.


PURPOSE

The purpose of Citadel PHP is to give users a means to change their passwords.

The server side protocols IMAP, SMTP etc. don't provide any means to change passwords.


INCLUDES

  • A library to access Citadel email and collaboration servers from php, using the Citadel Protocol.
  • A simple ajax driven website on which users can:
    • Login
    • Change Password

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync

Citadel PHP:
https://bitbucket.org/robotamer/citadelphp



[#] Sat Jan 18 2014 13:08:32 EST from TaMeR @ Uncensored

Subject: Re: ANN Citadel Sync Version 2 released

[Reply] [ReplyQuoted] [Headers] [Print]

 

Sorry, I replied too fast!
And there is no means of deleting my own message.

No, I haven't done any encoding, however there are libs available in Go to assist.

YAML don't make much sense, but I been looking in to TOML

I tried TOML a few weeks ago, but there are still too many bugs in the library.
Once it works, I will switch to TOML.

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync

Citadel PHP:
https://bitbucket.org/robotamer/citadelphp



[#] Sat Jan 18 2014 16:05:52 EST from dothebart @ Uncensored

Subject: Re: ANN Citadel Sync Version 2 released

[Reply] [ReplyQuoted] [Headers] [Print]

 

Sat Jan 18 2014 13:08:32 EST from TaMeR @ Uncensored Subject: Re: ANN Citadel Sync Version 2 released

 

Sorry, I replied too fast!
And there is no means of deleting my own message.

No, I haven't done any encoding, however there are libs available in Go to assist.

YAML don't make much sense, but I been looking in to TOML

I tried TOML a few weeks ago, but there are still too many bugs in the library.
Once it works, I will switch to TOML.

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync

Citadel PHP:
https://bitbucket.org/robotamer/citadelphp



hm, the purpose of the both seems to be rather the same (yaml/toml) if I get that correctly?

Having structured Information visible in ascii?

so - 'sense making' is here equal on both solutions; its rather a question of taste, if you like it more to look like a windows ini file, toml seems to be the choice, if you like it to look more like a regular structured, self explanatory text yaml.



[#] Sat Jan 18 2014 22:58:27 EST from TaMeR @ Uncensored

Subject: Re: ANN Citadel Sync Version 2 released

[Reply] [ReplyQuoted] [Headers] [Print]

 

Here is the WHY TOML from the TOML coders website

But why?

Because we need a decent human-readable format that unambiguously maps to a hash table and the YAML spec is like 80 pages long and gives me rage. No, JSON doesn't count. You know why.

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync

Citadel PHP:
https://bitbucket.org/robotamer/citadelphp



[#] Mon Jan 20 2014 00:46:51 EST from TaMeR @ Uncensored

Subject: [ANN] Citadel Sync Version 3 released

[Reply] [ReplyQuoted] [Headers] [Print]

 

Sync local files with a Citadel Mail Server

Citadel Sync can sync files with a specified room on a local or remote Citadel Mail Server.

You may sync any type of text files but Citadel Sync is most useful for

  • Contacts from vCards .vcf
  • Notes from vNotes .vnt
  • Calendar .vcs or .ics
  • Task .vcs or .ics
  • Text from any text based files .txt

 

Version 2 of Citadel Sync was an up loader, version 3 is now a full sync tool

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadelsync

Citadel PHP:
https://bitbucket.org/robotamer/citadelphp



[#] Tue Jan 21 2014 21:28:59 EST from IGnatius T Foobar @ Uncensored

Subject: Re: [ANN] Citadel Sync Version 3 released

[Reply] [ReplyQuoted] [Headers] [Print]

you guys are awesome. Thanks for the community contributions!

[#] Thu Jan 23 2014 14:57:04 EST from TaMeR @ Uncensored

Subject: Re: [ANN] Citadel Sync Version 3 released

[Reply] [ReplyQuoted] [Headers] [Print]

I's been a fun experience, and considering what Citadel has done for me so far, it's nothing really.

I am am actually replying to let people know that I have changed the location.
The new links are below.
I moved both in to a single repo, which makes development easier, sorry about that.

Also, you have version 2 of Citadel Sync in your files in this room, I suggest you delete it, or even better replace it with version 3.

Thanks

-- 
TaMeR

Citadel Sync:
https://bitbucket.org/gotamer/citadel/wiki/CitadelSync

Citadel Go Library:
https://bitbucket.org/gotamer/citadel

Citadel PHP:
https://bitbucket.org/robotamer/citadelphp



[#] Wed May 07 2014 23:57:51 EDT from IGnatius T Foobar @ Uncensored

Subject: Re: [ANN] Citadel Sync Version 3 released

[Reply] [ReplyQuoted] [Headers] [Print]

I've updated the contribs page [ http://www.citadel.org/doku.php/installation:source?&#third-partycontributions ] on the Citadel web site to reflect all of these.

[#] Fri Feb 06 2015 21:45:35 EST from TaMeR @ Uncensored

Subject: citadel as docker container

[Reply] [ReplyQuoted] [Headers] [Print]

 

Citadel is now available as a Docker container.

Any feedback, bug reports, and future request are welcome.



[#] Sat Feb 07 2015 14:10:38 EST from dothebart @ Uncensored

Subject: Re: citadel as docker container

[Reply] [ReplyQuoted] [Headers] [Print]

how do you do the basic setup? afair that was a problem before - the container has just a dummy hostname...



[#] Sat Feb 07 2015 14:55:13 EST from TaMeR @ Uncensored to room_citanews@uncensored.citadel.org

Subject: Re: [CitaNews] Re: citadel as docker container

[Reply] [ReplyQuoted] [Headers] [Print]

On 02/07/2015 09:10 PM, dothebart wrote:
how do you do the basic setup? afair that was a problem before - the
container has just a dummy hostname...


They added a new option to the command line to specify the hostname.
See `docker run` belpw


Docker image specific HowTo
===========================

After building enter your citadel container, and run `dpkg-reconfigure`
on `citadel-server` to set your
AIDE/Admin password.

citadel create
```
docker run -it --name="citadel" --hostname="mail.riky.net" acc12703ecf1
bash
dockersetlocalhosts v
dpkg-reconfigure citadel-server
doctrl clean
doctrl start
^P ^Q (exit)
```

citadel start up
```
docker start citadel
dockersetlocalhosts v
docker attach citadel
doctrl start
^P ^Q (exit)
```

Exit the container with `^p ^q`

Open a web browser and do go the containers ip address



systemd script
```
[Unit]
Description=Citadel container
Author=RoboTamer
After=docker.service
Requires=docker.service

[Service]
Restart=always
ExecStart=/usr/bin/docker start -a citadel
ExecStop=/usr/bin/docker stop -t 2 citadel
ExecStopPost=/bin/bash -c "/bin/systemctl stop docker-$(docker ps -a
--no-trunc |grep service |awk '{print $1}').scope"

[Install]
WantedBy=local.target
```

[#] Sat Feb 07 2015 15:01:20 EST from TaMeR @ Uncensored to room_citanews@uncensored.citadel.org

Subject: Re: citadel as docker container

[Reply] [ReplyQuoted] [Headers] [Print]

On 02/07/2015 09:10 PM, dothebart wrote:
how do you do the basic setup? afair that was a problem before - the
container has just a dummy hostname...


On that note, I also made a bash script that will update your
`/etc.hosts/` ip to hostname mapping.

See: https://bitbucket.org/robotamer/docker

Just run:

container hosts

[#] Thu Apr 02 2015 20:37:41 EDT from TaMeR @ Uncensored

Subject: [ANN] Citadel Sync Version 3.1

[Reply] [ReplyQuoted] [Headers] [Print]

New version and now with executable available for your platform too.

Executables available for

  • darwin/386
  • darwin/amd64
  • linux/386
  • linux/amd64
  • linux/arm
  • freebsd/386
  • freebsd/amd64
  • openbsd/386
  • openbsd/amd64
  • windows/386
  • windows/amd64
  • freebsd/arm
  • netbsd/386
  • netbsd/amd64
  • netbsd/arm
  • plan9/386

 

Fixed bug:

  • When deleted from Citadel it was not deleting the corresponding file.

 

Wiki:

https://bitbucket.org/gotamer/citadel/wiki/CitadelSync

Downloads:

https://bitbucket.org/gotamer/citadel/downloads

 



[#] Sun May 03 2015 01:42:47 EDT from ax25 @ Uncensored

Subject: Re: [ANN] Citadel Sync Version 3.1

[Reply] [ReplyQuoted] [Headers] [Print]

Thanks TaMeR.  I will check it out.  Might be a bit yet, as I seem to have some fear surrounding GO (the language).  I am not sure why though, so I will install it in a VM, and give it a spin :-)